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 (like Stripe API)

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.


Did this page help you?