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. EndpointsDocumentation Index
Fetch the complete documentation index at: https://docs.sudo.africa/llms.txt
Use this file to discover all available pages before exploring further.
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"
}
],
}