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

# Overview

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](/reference/get-transactions)          |
| `GET`  | [/cards/:id/transactions](/reference/get-card-transactions) |
| `GET`  | [/cards/transactions/:id](/reference/get-transaction)       |
| `PUT`  | [/cards/transactions/:id](/reference/update-transaction)    |

**Transaction** **Object**

<CodeGroup>
  ```json RESPONSE (STANDARD) theme={null}
  {
        "_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"
          }
        ],
      }
  ```
</CodeGroup>
