Skip to main content
POST
Generate Remita RRR Invoice
Generate an official Remita Retrieval Reference (RRR) on the fly for institutional payments like school fees, acceptance fees, court fees, or taxes.

Custom Fields

Universities and government agencies often require custom fields (e.g. matric_no, department, session, tax_id). You can supply these inside the customFields array.

Sample Request

Authorizations

Authorization
string
header
default:sk_test_handle_master_key
required

Supply your secret API key (e.g. sk_live_... or sk_test_...) in the Authorization header.

Body

application/json
billerId
string
default:SPECSELECTRICITY
required

Biller or institution identifier (e.g. SPECSELECTRICITY, S0000573002)

Example:

"SPECSELECTRICITY"

amount
number
default:1000
required

Payment amount in NGN

Example:

1000

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"

billPaymentProductId
string
default:9676615755

Specific service type ID (e.g. 9676615755)

Example:

"9676615755"

customFields
object[]

Custom institutional fields (e.g. Account Number, Matric No, Session)

Response

200 - application/json

Generated RRR code, payment identifier, and institutional invoice summary

success
boolean
Example:

true

message
string
Example:

"RRR generated successfully"

data
object