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.
Endpoints
| Method | Url |
|---|---|
GET | /cards/transactions |
GET | /cards/:id/transactions |
GET | /cards/transactions/:id |
PUT | /cards/transactions/:id |
Transaction Object
{
"_id": "61d7e0ce67ccf96ec7f893c0",
"business": "61d4150b00c7cdd1184ef455",
"customer": {
"_id": "61d6baf144b3a74b6b258630",
"business": "61d57b7ebc8deefb4330f5b4",
"type": "individual",
"name": "John Doe",
"status": "active",
"individual": {
"firstName": "John",
"lastName": "Doe",
"identity": {
"type": "BVN",
"number": "2343456543",
"_id": "61d6baf144b3a74b6b258632"
},
"_id": "61d6baf144b3a74b6b258631"
},
"billingAddress": {
"line1": "Ikeja, Lagos",
"line2": "",
"city": "Lagos",
"state": "Lagos",
"country": "Nigeria",
"postalCode": "100001",
"_id": "61d6baf144b3a74b6b258633"
},
},
"account": {
"_id": "61d7004261f2a5ebf1e18a61",
"business": "61d4150b00c7cdd1184ef455",
"type": "wallet",
"currency": "NGN",
"accountName": "SUDO / JOHN DOE",
"bankCode": "999240",
"accountType": "Current",
"accountNumber": "8016813168",
"currentBalance": 0,
"availableBalance": 0,
"provider": "SafeHaven",
"providerReference": "61d70040240846001ebeb8ff",
"referenceCode": "subacc_1641480256224",
"isDefault": true,
},
"card": {
"_id": "61d7004261f2a5ebf1e18a63",
"business": "61d4150b00c7cdd1184ef455",
"customer": "61d6baf144b3a74b6b258630",
"account": "61d7004261f2a5ebf1e18a61",
"fundingSource": "61d4150b00c7cdd1184ef459",
"type": "physical",
"brand": "Verve",
"currency": "NGN",
"maskedPan": "506100******2989",
"expiryMonth": "01",
"expiryYear": "2025",
"status": "active",
"spendingControls": {
"channels": {
"atm": true,
"pos": true,
"web": true,
"mobile": true,
"_id": "61d7004261f2a5ebf1e18a65"
},
"allowedCategories": [],
"blockedCategories": [],
"spendingLimits": [
{
"amount": 10000000,
"interval": "daily",
"categories": [],
"_id": "61d7004261f2a5ebf1e18a66"
}
],
"_id": "61d7004261f2a5ebf1e18a64"
},
},
"authorization": {
"_id": "61d7e0cd67ccf96ec7f893a4",
"business": "61d4150b00c7cdd1184ef455",
"customer": "61d6baf144b3a74b6b258630",
"account": "61d7004261f2a5ebf1e18a61",
"card": "61d7004261f2a5ebf1e18a63",
"amount": 105.375,
"fee": 5,
"vat": 0.375,
"approved": true,
"currency": "NGN",
"status": "approved",
"authorizationMethod": "chip",
"balanceTransactions": [],
"merchantAmount": 100,
"merchantCurrency": "NGN",
"merchant": {
"category": "3057",
"name": "SUDO SIMULATOR",
"merchantId": "SUDOSIMULATOR01",
"city": "JAHI",
"state": "AB",
"country": "UJ",
"postalCode": "100001",
"_id": "61d7e0cd67ccf96ec7f893a5"
},
"terminal": {
"rrn": "102910479385",
"stan": "111184",
"terminalId": "1SUDOSIM",
"terminalOperatingEnvironment": "on_premise",
"terminalAttendance": "unattended",
"terminalType": "adminstrative_terminal",
"panEntryMode": "magnetic_stripe",
"pinEntryMode": "magnetic_stripe",
"cardHolderPresence": true,
"cardPresence": true,
"_id": "61d7e0cd67ccf96ec7f893a6"
},
"transactionMetadata": {
"channel": "atm",
"type": "cash_withdrawal",
"reference": "1818113774102910479385",
"_id": "61d7e0cd67ccf96ec7f893a7"
},
"pendingRequest": null,
"requestHistory": [
{
"amount": 105.375,
"currency": "NGN",
"approved": true,
"merchantAmount": 100,
"merchantCurrency": "NGN",
"reason": "card_active",
"createdAt": "2022-01-07T06:42:21.663Z",
"_id": "61d7e0ce67ccf96ec7f893c5"
}
],
"verification": {
"billingAddressLine1": "not_provided",
"billingAddressPostalCode": "not_provided",
"cvv": "match",
"expiry": "match",
"pin": "match",
"threeDSecure": "not_provided",
"safeToken": "not_provided",
"authentication": "pin",
"_id": "61d7e0cd67ccf96ec7f893a9"
},
"isDeleted": false,
"createdAt": "2022-01-07T06:42:21.663Z",
"updatedAt": "2022-01-07T06:42:21.663Z",
"feeDetails": [
{
"contract": "61a18b8a4ddab599d20344a7",
"currency": "NGN",
"amount": 5,
"description": "Verve Card Authorization Fee",
"_id": "61d7e0cd67ccf96ec7f893aa"
}
],
"__v": 1
},
"amount": -105.375,
"fee": -5,
"vat": -0.375,
"currency": "NGN",
"type": "capture",
"balanceTransactions": [],
"merchantAmount": -100,
"merchantCurrency": "NGN",
"merchant": {
"category": "3057",
"name": "SUDO SIMULATOR",
"merchantId": "SUDOSIMULATOR01",
"city": "JAHI",
"state": "AB",
"country": "UJ",
"postalCode": "100001",
"_id": "61d7e0cd67ccf96ec7f893a5"
},
"terminal": {
"rrn": "102910479385",
"stan": "111184",
"terminalId": "1SUDOSIM",
"terminalOperatingEnvironment": "on_premise",
"terminalAttendance": "unattended",
"terminalType": "adminstrative_terminal",
"panEntryMode": "magnetic_stripe",
"pinEntryMode": "magnetic_stripe",
"cardHolderPresence": true,
"cardPresence": true,
"_id": "61d7e0cd67ccf96ec7f893a6"
},
"transactionMetadata": {
"channel": "atm",
"type": "cash_withdrawal",
"reference": "1818113774102910479385",
"_id": "61d7e0cd67ccf96ec7f893a7"
},
"feeDetails": [
{
"contract": "61a18b8a4ddab599d20344a7",
"currency": "NGN",
"amount": 5,
"description": "Verve Card Authorization Fee",
"_id": "61d7e0ce67ccf96ec7f893c4"
}
],
}