This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Configuring Recurly Operations

To use the Recurly connector, add the  <recurly.init>  element in your configuration before carrying out any other Recurly operations. 

Before you start performing various operations with the connector, make sure to import the Recurly certificate to your ESB client keystore.

Follow the below mentioned steps to add valid certificate to access Recurly API over https into the ESB client keystore:

  1. Extract the certificate from browse by navigating to ' https://app.recurly.com/ ' and click the lock icon on the address bar to view the certificate.
  2. Place the downloaded certificate into "Recurly_CONNECTOR_HOME/src/test/resources/keystores/products" folder.
  3. Navigate to "Recurly_CONNECTOR_HOME/src/test/resources/keystores/products/" using command prompt and execute the following command.
  4. This command will import Recurly certificate in to keystore. Give "wso2carbon" as password.To import the certificate give "wso2carbon" as password. Press "Y" to complete certificate import process.

    keytool -importcert -file CERT_FILE_NAME -keystore wso2carbon.jks -alias -alias "CERT_NAME"

Recurly uses HTTP basic authentication where the API key is securely encrypted by the SSL channel.  For more information on authentication, see https://docs.recurly.com/api/basics/authentication.

init
<recurly.init>
	<apiUrl>{$ctx:apiUrl}</apiUrl>
    <apiKey>{$ctx:apiKey}</apiKey>
</recurly.init>
Properties  
  • apiUrl:  The URL to access the Recurly API.
  • apiKey:  The API key of a valid Recurly account.

Additional information

Ensure that the following Axis2 configurations are added and enabled in the <ESB_HOME>\repository\conf\axis2\axis2.xml file.

Required message formatters
messageFormatters
<messageFormatter contentType="text/html" class="org.wso2.carbon.relay.ExpandingMessageFormatter"/>
Required message builders
messageBuilders
<messageBuilder contentType="text/html" class="org.wso2.carbon.relay.BinaryRelayBuilder"/>

Configuring the operations

Now that you have connected to Recurly, use the information in the following topics to perform various operations with the connector.