Get bank transfer details to pay
For your own payment screen. Returns a one-time account number for this session; when
the buyer transfers exactly amount to it before expires_at, the escrow is funded and
escrow.funded is sent. Calling again returns the same account while it is valid.
Needs the buyer’s customer token, so the payer is verified before money is taken. If the
amount is above the buyer’s verification level, this fails with verification_required;
send the buyer to the session’s url to verify. Card payments go through KetaPay’s
secure card fields (in @ketapay/checkout or the hosted page) so card numbers never
touch your servers.
Authorizations
Authorization: Bearer <secret key>. Secret keys belong to your organisation, are shown
once when created in the dashboard, and are scoped (see x-required-scope on each
operation). Keep them on your server. Live keys are issued after your business is
verified. Publishable keys (pk_) are only for @ketapay/checkout and don't work here.
Proof that your customer approved this call, from POST /customer_sessions/{id}/verify.
Sent together with your secret key. Valid for 15 minutes, for that customer's escrows
only.
Headers
Unique key for this operation. Retries with the same key return the first result.
255"7f3e2a10-6c4d-4b8e-9a1f-2d5c8e7b6a40"
Path Parameters
Response
Transfer details
"bank_transfer_instructions""Zenith Bank"
^\d{10}$"9912345678"
"KetaPay Escrow / Ada Obi"
Transfer exactly this (the buyer's total)
x >= 0152418750