Confirm a payin with a code
Completes a payin whose creation returned otpRequired: true (e.g. Orange Money Côte d’Ivoire and Burkina Faso).
Show the customer otpInstructions, collect the code they generate on their phone, then send it here.
On success the payin moves to PROCESSING; the final result arrives by webhook. Errors: bad_status (payin no longer PENDING), otp_unsupported (this payin doesn’t use a code), otp_failed (wrong code or refused by the operator — let the customer generate a new code and retry).
API key scope: payins:write
Authorizations
Secret API key from Dashboard → Developers: kp_sandbox_… for Sandbox, kp_live_… for Production. Server-side only.
Path Parameters
Payin reference (tx_…) or id.
Body
Code generated by the customer, as they typed it.
3 - 12