CentaPay

Last updated

Testing#

Everything you can exercise before you have production credentials. The test cards below drive the sandbox engine, and the two procedures after them cover the cases no card can produce: a callback that fails to deliver, and a chargeback.

Availability. CentaPay is pre-launch. Production is expected in Q4 2026, with sandbox access ahead of it. Coverage differs by market, and the payment methods available differ by market too. The coverage table on our main site is the single source for what is live where, and for current dates. Nothing in this documentation should be read as a service available today.

Sandbox moves no money. Your PAYMENT_URL differs between sandbox and production and is issued with your credentials, so there is no address to publish here: see Credentials and environments.

Testing callback failure handling#

No feature forces a callback to time out, so the delivery schedule is exercised by making your own endpoint fail. Point the callback URL at an endpoint you control, have it delay past your timeout or return a status other than 200, and watch the four attempts arrive.

The callback URL is configured per account, not per request. A callback_url sent as a request parameter on a server-to-server operation such as SALE is ignored.

Producing a chargeback in sandbox#

No test card produces one. Sandbox has no card network behind it, so there is nothing to raise a dispute.

Support can create one by hand instead. Settle a sandbox payment, then ask support to trigger a chargeback against it, naming the payment. They record a CHARGEBACK transaction carrying a reason code and a date, and the platform then sends the CHARGEBACK callback exactly as it would in production.

That makes the callback path testable end to end even though the dispute itself is manufactured. What it does not exercise is the timing, since a real chargeback arrives days or weeks after the payment and this one arrives when support creates it.

What next#

Handling a chargeback once it arrives, and the rest of running a live integration, are on Operations. When every item here passes, work through the go-live checklist.

Technical questions go to [email protected].

Test Cards#

Use these test values in the sandbox environment. All transactions are processed by the test engine, no real funds are moved. Use any 3-digit CVV.

S2S CARD: Scenario Simulation

All scenarios use card number 4111111111111111. The expiry date determines the outcome:

ExpiryScenarioResponse
01/2038 Successful SALE (also use for recurring init. Only card that returns recurring_token) result: SUCCESS, status: SETTLED
AUTH: status: PENDING
02/2038 Declined SALE / AUTH result: DECLINED, status: DECLINED
03/2038 Successful AUTH, then declined CAPTURE AUTH: SUCCESS/PENDING
CAPTURE: DECLINED/PENDING
05/2038 3DS verification → Success SALE: REDIRECT/3DS → After ACS: SUCCESS/SETTLED
06/2038 3DS verification → Decline SALE: REDIRECT/3DS → After ACS: DECLINED
12/2038 Redirect → Success SALE: REDIRECT/REDIRECT → Return: SUCCESS/SETTLED
12/2039 Redirect → Decline SALE: REDIRECT/REDIRECT → Return: DECLINED

CREDIT2CARD Test Card

Card NumberScenarioResponse
4601541833776519 Successful card payout result: SUCCESS, status: SETTLED
Recurring token generation only works with 4111111111111111 expiry 01/2038. Other test cards will process the SALE but will not return a recurring_token.