REreflexpay
Transactions

Accept a pending transaction

Changed on

The receiving application calls this to accept an AWAITING_ACCEPTANCE transaction.

On acceptance:

  • Sender application's escrow wallet is debited.
  • Receiver application's escrow wallet is credited.
  • Two immutable LedgerEntry rows are written (DEBIT + CREDIT).
  • Transaction status moves to COMPLETED.
  • Sender is notified via webhook callback URL.
post/v1/transactions/{reference}/accept

Request

Path parameters

referencestring required

Transaction reference

Response

Transaction accepted and completed

successboolean
messagestring
errorCodestring
errorsstring[]
timestampstring date-time

Example response

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "reference": "TXN-16820000-AB1C2D3E",
    "senderTag": "@alice",
    "senderAppName": "WalletApp",
    "receiverTag": "@bob",
    "receiverAppName": "PaymentsApp",
    "amount": 1500,
    "currency": "NGN",
    "status": "AWAITING_ACCEPTANCE",
    "narration": "School fees payment",
    "webhooks": [
      {
        "transactionReference": "TXN-16820000-AB1C2D3E",
        "targetUrl": "https://app-b.example.com/webhooks/transactions",
        "eventType": "TRANSACTION_INITIATED"
      }
    ]
  }
}

Changes

  • db1f954badfbRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status