Business Use Cases

In all of the following cases, we encourage partners to store Coda information and link it to their own customer identifier: Shopper ID, Payment Method ID, Token ID, and Subscription ID.

New Customer Registering

In the case where a partner need to create a token for the first time for a customer, the partner will need to perform the following actions:

  1. Create a new Shopper using their customer ID.

  2. Create a Payment Method depending on the customer's payment choice (ex: Go-Pay.)

  3. Generate a Token for that payment method.

  4. Wait for token validation by listening to Coda notification, which the partner can config Subscription Notification URL.

  5. Charge the customer using the generated token.

Returning Customers Using the Same Payment Method

In a case where the partner already have a token linked to your customer, the partner can:

  1. Charge the customer using the generated token.

Returning Customers but Payment Token has Expired

In a case where the partner's existing customer needs to re-generate a token:

  1. Generate a new Token for the customer's payment method.

  2. Wait for token validation by listening to Coda notification.

  3. Charge the customer using the newly generated token.

Returning Customers Using a Different Payment Method

In a case where an existing customer needs to generate a token for another payment method:

  1. Create a Payment Method depending on the customer payment choice (ex: Go-Pay) using the existing Shopper ID linked to your customer ID.

  2. Generate a Token for that payment method.

  3. Wait for token validation by listening to Coda notification.

  4. Charge the customer using the newly generated token.

Initiating Subscription

If a partner wants to use Coda scheduler to initiate a recurring charge for their customers, the partner will need to go through the following steps

  1. Create a new subscription plan (to be done only once per plan.)

  2. Create a new Shopper using the partner's customer ID.

  3. Create a Payment Method depending on the customer's payment choice (ex: Go-Pay.)

  4. Generate a Token for that payment method.

  5. Wait for token validation by listening to Coda notification.

  6. Launch the subscription using the subscription plan and the newly generated token.

Cancelling Subscription

If a partner wants to cancel a customer subscription, they can cancel an existing subscription using the ID generated.

Last updated