Transactions

Once an authorization request is approved, the status on the authorization is updated to pending, and the authorization.updated webhook event is sent. The amount is deducted from your default available balance. A transaction is then created and the status of the authorization is set to closed.

Refunds and Reversals

When a dispute is raised on a transaction or a reversal is initiated by the switching network, we create a new transaction it's type is set to refund, and all amounts in positive. We keep every other detail as it is in the original transaction including the authorization that leads to the refund. We also send a transaction.refund event with the details of the refunded transaction to your webhook.

{
    ... 
    
    "amount": 10,
    "fee": 5,
    "vat": 0.375,
    "feeDetails": [
        {
            "_id": "5f9217807f397914cb365101",
            "contract": "5f919ef0d466350ec7a8f0b7",
            "currency": "NGN",
            "amount": 5,
            "description": "Naira Card Authorization Fee"
        }
    ],
    "currency": "NGN",
    "type": "refund",
    "merchantAmount": 10,
    "merchantCurrency": "NGN",
    "merchant": {
        "_id": "5f9217807f397914cb3650e8",
        "category": "7399",
        "name": "PayantTechnolog/FLW3518",
        "merchantId": "IPG000000000003",
        "city": "interswitchde",
        "state": "LA",
        "country": "NG",
        "postalCode": "100001"
    },
    "terminal": {
        "_id": "5f9217807f397914cb3650e9",
        "rrn": "001249814944",
        "stan": "280648",
        "terminalId": "3IPG0001",
        "terminalOperatingEnvironment": "off_premise",
        "terminalAttendance": "unattended",
        "terminalType": "adminstrative_terminal",
        "panEntryMode": "unknown",
        "pinEntryMode": "unknown",
        "cardHolderPresence": false,
        "cardPresence": false
    },
    "transactionMetadata": {
        "_id": "5f9217807f397914cb3650ea",
        "channel": "atm",
        "type": "purchase",
        "reference": "6050000406001249814944"
    },
    "isDeleted": false,
    "createdAt": "2020-10-23T00:56:16.113Z",
    "updatedAt": "2020-10-23T00:56:16.113Z",
    "__v": 0
}
```