Custom Card Payment Guidelines

If for any reason you wish to use a Card Payment provider we do not support, then you can optionaly create the intergration yourself.

Do do this you must provide a custom payment URL in the payment provider plugin . The URL you provide will be called with a number of payloads and you should respond in a way that the Cloudshelf Platform expects; but importantly you can do whatever you wish with the payloads.

You provide:

And we will send POST requests to this URL, there are a number of payloads and responses that you will need to support, these are:

1. Generating a payment token
2. Starting a payment request
3. Aborting a payment request
4. Checking a payment request status

The Cloudshelf Platform requires that a token has been generated for each request, and this token will be passed long to the start, abort and checking functions. Below are example POST payloads we send, and the expected result.

It's important to note that the mmount value sent is in the lowest value currency (cents).

Typescript Interfaces for each payload are as follows: