Skip to main content
POST
Initiate Payment & Generate RRR
Initiate an institutional biller payment and dynamically generate a Remita Retrieval Reference (RRR) along with a paymentIdentifier for instant settlement.

Successful Response

Authorizations

secretKey
string
header
default:sk_test_l/pQgOLgziOTzb+7pcUXVH2iX1MlpROsePDkNi/g/QmMs2c8P0DPr1vUP7xESiGG
required

SystemSpecs Demo / Live Secret Key

Body

application/json
billerId
string
default:SPECSELECTRICITY
required
Example:

"SPECSELECTRICITY"

billPaymentProductId
string
default:9676615755
required
Example:

"9676615755"

amount
number
default:1000
required
Example:

1000

currency
string
default:NGN
required
Example:

"NGN"

payerName
string
default:Ayodeji Peters
required
Example:

"Ayodeji Peters"

payerEmail
string
default:ayodeji@example.com
required
Example:

"ayodeji@example.com"

payerPhone
string
default:08012345678
required
Example:

"08012345678"

clientReference
string
default:init_hdl_1790800000
required
Example:

"init_hdl_1790800000"

customFields
object[]

Response

200 - application/json

Generated RRR and payment identifier

status
string
Example:

"00"

message
string
Example:

"RRR generated successfully"

data
object