TchokoPay
API Reference

Get a payment

GET /v1/payments/:reference — check a payment's current status.

GET/v1/payments/:reference

Returns the current state of a payment. Same response shape as creating a payment.

curl https://connect.tchokopay.com/v1/payments/REQ-1785296850838-A5303B \
  -H "Authorization: Bearer tchoko_live_..."

Response

200 OK — identical shape to POST /v1/payments.

Scoped to your own account: a reference that exists but belongs to another merchant returns 404, exactly like a reference that doesn't exist at all — so this endpoint can never be used to probe whether a reference exists.

Errors

StatusMeaning
401Missing, invalid, or revoked API key.
404No payment with this reference on your account.

Create a payment

POST /v1/payments — create a hosted checkout payment.

List channels

GET /v1/channels — check what payment channels are available to you.

On this page

ResponseErrors