> ## Documentation Index
> Fetch the complete documentation index at: https://docs.handle.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Pay Existing RRR Invoice

> Settle an existing Remita Retrieval Reference (RRR) invoice using Handle account debit mandate.

Settle any existing 12-digit RRR code that was previously generated on a university portal, CAC, FIRS, FRSC, or Immigration website.

### Settlement Mechanism

Handle executes direct Account-to-Account (A2A) settlement from the customer's linked bank account via mandate, marks the invoice as `PAID` with Remita, and delivers the official payment receipt.

### Sample Request

```bash theme={null}
curl --request POST \
  --url 'https://api-local.handle.ng/api/v1/bill-payment/rrr/pay' \
  --header 'Authorization: Bearer sk_test_handle_master_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "rrr": "220799679350",
    "amount": 1000
  }'
```


## OpenAPI

````yaml openapi.json POST /bill-payment/rrr/pay
openapi: 3.0.3
info:
  title: Handle Merchant Payment Gateway API
  description: >-
    Developer API specification for accepting cardless, instant
    Account-to-Account (A2A) payments via Handle.
  version: 1.0.0
  contact:
    name: Handle Developer Support
    email: support@handle.ng
    url: https://handle.ng
servers:
  - url: https://api-local.handle.ng/api/v1
    description: Local Development (SSL)
  - url: https://api.handle.ng/api/v1
    description: Production Live Gateway
security:
  - BearerAuth: []
paths:
  /bill-payment/rrr/pay:
    post:
      tags:
        - VAS & Bill Payments
      summary: Pay Remita RRR Invoice
      description: >-
        Execute instant payment for any Remita Retrieval Reference (RRR) invoice
        using Handle mandate debit.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - rrr
                - amount
              properties:
                rrr:
                  type: string
                  default: '220799679350'
                  example: '220799679350'
                amount:
                  type: number
                  default: 1000
                  example: 1000
                bankAccountId:
                  type: string
                  description: Optional specific bank account ID to debit
      responses:
        '200':
          description: Payment confirmation, receipt reference, and settlement status
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Bill processed successfully
                  transactionId:
                    type: string
                    example: tx_cly982341908236
                  data:
                    type: object
                    properties:
                      rrr:
                        type: string
                        example: '220799679350'
                      amount:
                        type: number
                        example: 1000
                      paymentIdentifier:
                        type: string
                        example: RRR_PAY_172778810293_ab92df
                      transactionStatus:
                        type: string
                        example: SUCCESS
                      billerName:
                        type: string
                        example: ABUJA ELECTRICITY DISTRIBUTION COMPANY
                      payerName:
                        type: string
                        example: Ayodeji Peters
              example:
                success: true
                message: Bill processed successfully
                transactionId: tx_cly982341908236
                data:
                  rrr: '220799679350'
                  amount: 1000
                  paymentIdentifier: RRR_PAY_172778810293_ab92df
                  transactionStatus: SUCCESS
                  billerName: ABUJA ELECTRICITY DISTRIBUTION COMPANY
                  payerName: Ayodeji Peters
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Supply your secret API key (e.g. `sk_live_...` or `sk_test_...`) in the
        Authorization header.
      x-default: sk_test_handle_master_key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.