Skip to main content
POST
/
subsidiary
/
collections
/
v1
/
process-otp
XOF Process OTP
curl --request POST \
  --url https://api.payaza.africa/live/subsidiary/collections/v1/process-otp \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'X-ProductID: <api-key>' \
  --header 'X-TenantID: <api-key>' \
  --data '
{
  "payment_token": "45c3d124-7831-4f97-8844-581bf497a20b",
  "otp_code": "4567",
  "payee": "+2251114462945",
  "payment_method": "ORANGE_CI",
  "transaction_reference": "MOCIV0009383",
  "transaction_channel": "MOMCIV",
  "country_code": "CI"
}
'
{
  "response_code": "09",
  "response_message": "PENDING",
  "redirect_customer_to_url_processing": false
}

Authorizations

Authorization
string
header
required

Payaza {{Public API Key in Base 64}}

X-TenantID
string
header
required

live or test

X-ProductID
string
header
required

default value is ‟app”

Body

application/json
payment_token
string
required

The payment token, this can be retrieved from the “Process Collection” API response.

Example:

"45c3d124-7831-4f97-8844-581bf497a20b"

otp_code
string
required

The One Time Password sent to the customer.

Example:

"4567"

payee
string
required

The mobile money account number to be charged.

Example:

"+2251114462945"

payment_method
string
required

The payment method. The default value is ORANGE_CI.

Example:

"ORANGE_CI"

transaction_reference
string
required

The unique identifier of the transaction.

Example:

"MOCIV0009383"

transaction_channel
string
required

This is the customer’s mobile money bank code.

Example:

"MOMCIV"

country_code
string
required

The ISO Country Code. (ISO 3166-1 alpha-2).

Maximum string length: 2
Example:

"CI"

Response

Funding Successful

response_code
string

Code representing the status of the request (e.g., '09' for pending).

Example:

"09"

response_message
string

Text description of the response code.

Example:

"PENDING"

redirect_customer_to_url_processing
boolean

Indicates whether the customer must be redirected to a URL to complete the action.

Example:

false