Testing

Keys that start with sk_test_ run everything against test money. The key decides the environment, and every object carries livemode. The base URL is the same as live, https://api.ketapay.com/v1. Get a test key in the business dashboard: switch it to Test and create one in Settings > API keys. No account yet? Use the public key on the Playground.

What’s different in test mode

No codes are sent

Every one-time code is 123456. Other emails your test deals cause go out with [TEST] in the subject.

Pay from code

Fund a session with the test helper, exactly like a real payment, without opening the checkout.

Move escrows on

Simulate what the buyer, seller or KetaPay would do, and get the same webhooks.

Payouts that fail

Test payout accounts succeed or fail on purpose, so you can handle payout.failed.

Test helpers return 404 test_mode_only with a live key.

One-time codes

What	Value
Customer session code (buyer or seller)	`123456`
Payout account confirmation code	`123456`

Paying a checkout session

Method	How
From code	`POST /test_helpers/checkout_sessions/{id}/pay` funds it like a real payment
Checkout, card	Use a test card the checkout shows in test mode
Checkout, bank transfer	Pick Bank transfer, then tap I’ve sent the money

After a payment, Test again on the checkout makes a copy of the same session to pay again.

Payout accounts

Account number	Bank	Result
`0000000000`	Any	Payouts succeed (`payout.sent`)
`0000000001`	Any	Payouts fail (`payout.failed`)

Moving an escrow

POST /test_helpers/escrows/{id}/simulate does what the buyer, the seller or KetaPay would do, and sends the same webhooks.

await ketapay.testHelpers.escrows.simulate(escrowId, {
  action: 'deliver',
  milestone_id: milestoneId,
})

$ketapay->testHelpers->escrows->simulate($escrowId, [
    'action' => 'deliver',
    'milestone_id' => $milestoneId,
]);

`action`	Simulates
`deliver`	The seller marks a milestone delivered
`release`	The buyer releases a milestone
`auto_release`	The release timer running out
`cancel`	A cancellation and refund
`open_dispute`	A dispute (`actor`, `reason`)
`request_evidence`	KetaPay asking for evidence (`from`)
`resolve_dispute`	KetaPay’s decision (`outcome`, `refunded_amount`)
`open_chargeback` / `close_chargeback`	A card chargeback and its result (`chargeback_status`)
`fail_payout`	A seller payout failing
`fail_refund`	A refund to the buyer failing

Going live

Live keys (sk_live_) move real money. They’re issued once your business is verified in the dashboard, and nothing else in your code changes. Work through the go-live checklist first.

Get started

Accept payments

Escrow

Customers

After payment

Integrate

What’s different in test mode

No codes are sent

Pay from code

Move escrows on

Payouts that fail

One-time codes

Paying a checkout session

Payout accounts

Moving an escrow

Going live

​What’s different in test mode

No codes are sent

Pay from code

Move escrows on

Payouts that fail

​One-time codes

​Paying a checkout session

​Payout accounts

​Moving an escrow

​Going live

What’s different in test mode

One-time codes

Paying a checkout session

Payout accounts

Moving an escrow

Going live