### External Payment Token

#### uuid
- **required**  
Globally unique identifier for the external payment

#### memo
- **string**

#### effective_date
- **date**  
- **required**

### Response

#### 200 OK
- **object**  
Base class for all transaction types in the ledger service

##### Properties
- **status**  
  - string  
  - **enum**  
  - **required**  
  - The status of the transaction

- `PENDING`  
    - `SETTLED`  
    - `DECLINED`  
    - `REVERSED`  
    - `CANCELED`  
    - `RETURNED`

- **token**  
  - uuid  
  - **required**  
  - Unique identifier for the transaction

- **created**  
  - date-time  
  - **required**  
  - ISO 8601 timestamp of when the transaction was created

- **updated**  
  - date-time  
  - **required**  
  - ISO 8601 timestamp of when the transaction was last updated

- **family**  
  - const  
  - **enum**  
  - **required**  
  - `EXTERNAL_PAYMENT` - External Payment Response

- **result**  
  - string  
  - **enum**  
  - **required**  
  
    - `APPROVED`
    - `DECLINED`

- **category**  
  - string  
  - **enum**  
  - **required**  
  
    - `EXTERNAL_WIRE`
    - `EXTERNAL_ACH`
    - `EXTERNAL_CHECK`
    - `EXTERNAL_FEDNOW`
    - `EXTERNAL_RTP`
    - `EXTERNAL_TRANSFER`

- **settled_amount**  
  - integer  
  - **required**

- **pending_amount**  
  - integer  
  - **required**

- **currency**  
  - string  
  - **required**

- **events**  
  - array of objects  
  - **required**

##### Event Object
- **amount**  
  - integer  
  - **required**

- **type**  
  - string  
  - **enum**  
  - **required**

- `EXTERNAL_WIRE_INITIATED`
    - `EXTERNAL_WIRE_CANCELED`
    - `EXTERNAL_WIRE_SETTLED`
    - `EXTERNAL_WIRE_REVERSED`
    - `EXTERNAL_WIRE_RELEASED`
    - `EXTERNAL_ACH_INITIATED`
    - `EXTERNAL_ACH_CANCELED`
    - `EXTERNAL_ACH_SETTLED`
    - `EXTERNAL_ACH_REVERSED`
    - `EXTERNAL_ACH_RELEASED`
    - `EXTERNAL_TRANSFER_INITIATED`
    - `EXTERNAL_TRANSFER_CANCELED`
    - `EXTERNAL_TRANSFER_SETTLED`
    - `EXTERNAL_TRANSFER_REVERSED`
    - `EXTERNAL_TRANSFER_RELEASED`
    - `EXTERNAL_CHECK_INITIATED`
    - `EXTERNAL_CHECK_CANCELED`
    - `EXTERNAL_CHECK_SETTLED`
    - `EXTERNAL_CHECK_REVERSED`
    - `EXTERNAL_CHECK_RELEASED`
    - `EXTERNAL_FEDNOW_INITIATED`
    - `EXTERNAL_FEDNOW_CANCELED`
    - `EXTERNAL_FEDNOW_SETTLED`
    - `EXTERNAL_FEDNOW_REVERSED`
    - `EXTERNAL_FEDNOW_RELEASED`
    - `EXTERNAL_RTP_INITIATED`
    - `EXTERNAL_RTP_CANCELED`
    - `EXTERNAL_RTP_SETTLED`
    - `EXTERNAL_RTP_REVERSED`
    - `EXTERNAL_RTP_RELEASED`

- **result**  
  - string  
  - **enum**  
  - **required**

- `APPROVED`
    - `DECLINED`

- **detailed_results**  
  - array of objects  
  - **required**

- `APPROVED`
    - `INSUFFICIENT_FUNDS`

- **created**  
  - date-time  
  - **required**

- **token**  
  - uuid  
  - **required**

- **memo**  
  - string  
  - **required**

- **effective_date**  
  - date  
  - **required**

- **user_defined_id**  
  - string | null

- **financial_account_token**  
  - uuid  
  - **required**

- **payment_type**  
  - string  
  - **enum**  
  - **required**

- `DEPOSIT`
    - `WITHDRAWAL`

### Error Responses

#### 400
A parameter in the query given in the request does not match the valid queries for the endpoint.

#### 401
- User has not been authenticated
- Invalid or missing API key
- API key is not active
- The API key used is no longer active
- Could not find API key
- The API key provided is not associated with any user
- Please provide API key in Authorization header
- The Authorization header is not in the request
- Please provide API key in the form Authorization: [api-key]
- The Authorization header is not formatted properly
- Insufficient privileges. Issuing API key required
- Insufficient privileges to create virtual cards.

#### 404
The specified resource was not found.

#### 429
Client has exceeded the number of allowed requests in a given time period.
- Rate limited, too many requests per second
- Rate limited, reached daily limit
- Rate limited, too many keys tried

### Example Request
```bash
curl --request POST \ 
     --url https://sandbox.lithic.com/v1/external_payments/external_payment_token/reverse \ 
     --header 'accept: application/json' \ 
     --header 'content-type: application/json' \ 
     --data '  \n{\n  "memo": "string",\n  "effective_date": "2026-07-18"\n}'
```

### Example Response
```json
{  
  "status": "PENDING",  
  "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  
  "created": "2026-07-18T00:25:32.427Z",  
  "updated": "2026-07-18T00:25:32.427Z",  
  "family": "string",  
  "result": "APPROVED",  
  "category": "EXTERNAL_WIRE",  
  "settled_amount": 0,  
  "pending_amount": 0,  
  "currency": "string",  
  "events": [\  
    {\  
      "amount": 0,\  
      "type": "EXTERNAL_WIRE_INITIATED",\  
      "result": "APPROVED",\  
      "detailed_results": [\  
        "APPROVED"\  
      ],\  
      "created": "2026-07-18T00:25:32.427Z",\  
      "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\  
      "memo": "string",\  
      "effective_date": "2026-07-18"\  
    }\  
  ],  
  "user_defined_id": "string",  
  "financial_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  
  "payment_type": "DEPOSIT"  
}
```