Reference Materials
Good to know
While building a connector please bear in mind the points below:
-
Idempotency - requests made by connector should be idempotent. This serves to avoid sending multiple requests and overcharging a user.
-
Webhook Response Code “200” - responses to webhooks need to return “200” response code, or they will be resent.
-
“Zero” Payments - some payment gateways do not support “zero” payments. Handling of such scenarios (e.g. free trial) requires additional attention.
-
Each payment in Cleeng should have externalPaymentId (the same as the payment identifier from an external payment gateway system).
PCI DSS Compliance
The PCI DSS (Payment Card Industry Data Security Standard) is a set of rules that aim to ensure that companies safely handle cardholder data (i.e., credit card information). For more information please see here.
All merchants who process credit card information must be PCI compliant.
For payment gateways when a broadcaster is their own MoR, the broadcaster is responsible for their own PCI compliance.
Cleeng is PCI-compliant through Adyen and PayPal for all Cleeng Merchant clients.
Glossary
Term | Description |
---|---|
Client App | The standalone application you have developed |
Payments Connector | Standalone, remote (preferred backend) application, that is responsible for the communication between Payment Gateway API and Cleeng Payment API |
Payment Gateway API | Remote payment gateway |
Cleeng Payment API | REST Cleeng Payment API |
Cleeng Webhooks | Cleeng's notification server |
Recurring Token | An identifier that entitles Cleeng to process payments; it is required if recurring payments are to be processed properly. It is created by a payment gateway. |
Updated almost 2 years ago