Subscriptions on Apaya Checkout

Send your users to the Apaya Checkout where they can select their desired payment mechanism and subscribe to your service. Apaya will manage the identification, subscription, and billing for all users. Ability to perform refunds is available depending on the payment mechanism.

Breakdown of steps:

  1. Generate a unique token to access the Apaya Checkout by calling the RequestToken API method.
    Note: You must use a tokenTypeId of 4 when requesting a token for the Apaya Checkout.

  2. Send your user to the Apaya Checkout URL by appending the token, https://pay.apaya.io/[token].e.g. https://pay.apaya.io/WHrH7zOq2hnDbJcYUuSgUXLwZ9J0LEfqemRV2x12345

  3. Your user will perform their transaction on the Apaya Checkout, and upon successful completion, or upon transaction failure (or if the user cancels the flow mid-way) they are returned to your endpoint. Note: This return endpoint is configured by Apaya on a product-by-product basis.

  4. The user will return to your endpoint containing the following information in the URL:
    e.g.http://www.example.com/?token=A9IotQFdJBSYjth7h)hGWmFAgzVjxU6xeGGT)AaAbB= &success=1&pt=ExamplePTValue&status=SUCCESS

    • token - Populated with the original token passed in when starting the Apaya Checkout flow.

    • pt - The pass-through value provided in the Token

    • success - '1' signifying that successful acquisition has taken place. '0' if not.
      Note: 'success' parameter will not be returned in the return URL when the end-user clicks to 'cancel and return' thus abandoning the flow. The 'status' in this case will contain 'ABANDONED'.

    • status - Contains a brief description of the status of the user during/after the acquisition flow. See Status Values for details.

  5. Log details of the transaction in your platform and if successful, give the user access to their service.

  6. The Apaya platform can also send asynchronous webhook notifications to your platform with subscription and billing information. Click here for more details.

Get Production access:

  1. Once you're happy with your Sandbox tests and you want Production access, sign in and go to Products and click on Production. Configure a 'subscription' just as you did for Sandbox. Give your subscription a relevant name, again you can change this later if required.

  2. Your Production subscription will be sent to Apaya for approval. Once approved, you will have access to the production API. Click on the green 'Try It' button to test your request and see a response from any of the required production API methods. Note: Your API access key will only be pre-populated after your Production subscription request has been approved by Apaya.

  3. If you require any assistance, contact us on support@apaya.io