Skip to main content
POST
1-Step Generate & Pay RRR Invoice
The recommended atomic flow for universities and institutions. Generates the RRR code behind the scenes and immediately executes settlement against the user’s linked bank account.

Why Use 1-Step Generate & Pay?

  • Zero Copy-Paste: The customer does not have to copy or re-enter the 12-digit RRR code.
  • Single Confirmation: Customer confirms once, and Handle performs the generation, mandate debit, and settlement simultaneously.
  • Immediate Official Receipt: Delivers the completed payment reference and settlement receipt in a single response.

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"

bankAccountId
string

Optional specific bank account ID to debit

customFields
object[]

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

Response

200 - application/json

Settlement confirmation, generated RRR, and institutional receipt

success
boolean
Example:

true

message
string
Example:

"Bill processed successfully"

transactionId
string
Example:

"tx_cly982341908235"

data
object