POST
/
intents
/
{id}

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
integer
required

ID of intent to update

Body

application/json
status
enum<string>
required

Status of the payment

Available options:
charged,
failed,
reversed
sessionId
string
required

A unique session reference to identify by the acquirer

channel
enum<string>
required

Channel used to process the payment

Available options:
nip,
intrabank
chargeId
string
required

Charge ID returned from initiate intent request

amount
integer
required

Amount charged without fees (must be in smallest currency unit eg. kobo)

accountNumber
string
required

Payer's account number

failureReason
enum<string>

Reason why payment failed

Available options:
insufficient_balance,
post_no_debit,
amount_exceeds_limit,
interbank_channel_failure,
daily_limit_exceeded,
internal_system_error

Response

201 - application/json
id
string

ID of the Intent

status
enum<string>

Status of the payment intent

Available options:
initiated,
awaiting_charge,
charged,
failed,
cancelled,
reversed,
completed