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

# AFT Parameters

> Additional parameters required when creating a Payment Intent for account funding transactions (AFT).

When the business scenario involves fund transfers, additional AFT (Account Funding Transaction)–related parameters should be provided when creating a Payment Intent. Below is the reference for these parameters.

## Parameter Reference

All fields below are part of the `recipient_sender_details` object.

| Object        | Field            | Type   | Constraint                                                                           | Description                                                                                                                                                                                                |
| :------------ | :--------------- | :----- | :----------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **(root)**    | `fund_source`    | String | **Required.** Must be one of: `01`, `02`, `03`, `04`, `05`, `06`, `25`               | **Source of funds codes:**<br />`01`: Credit Card<br />`02`: Debit Card<br />`03`: Prepaid Card<br />`04`: Cash<br />`05`: Debit/Deposit Account<br />`06`: Credit Account<br />`25`: Mobile Money Account |
| **recipient** | `first_name`     | String | **Required.** `^[a-zA-Z0-9 \-]{1,30}$`                                               | Recipient's (Main Account Holder) first name.                                                                                                                                                              |
|               | `last_name`      | String | **Required.** `^[a-zA-Z0-9 \-]{1,30}$`                                               | Recipient's last name.                                                                                                                                                                                     |
|               | `birth`          | String | **Required.** Must be exactly 8 digits in YYYYMMDD format                            | Recipient's date of birth.                                                                                                                                                                                 |
|               | `account_number` | String | **Required.** `^[a-zA-Z0-9*]{8}$`                                                    | Recipient's PAN or account number.                                                                                                                                                                         |
|               | `postcode`       | String | **Required.** `^[a-zA-Z0-9 /\-]{1,10}$`                                              | Recipient's postal code.                                                                                                                                                                                   |
|               | `street`         | String | **Required.** `^['"0-9A-Za-z]{1,30}$`                                                | Recipient's detailed address.                                                                                                                                                                              |
|               | `city`           | String | **Required.** `^['"0-9A-Za-z]{1,25}$`                                                | Recipient's city.                                                                                                                                                                                          |
|               | `state`          | String | **Required when `country_code` is `CAN`/`USA`/`COL`/`NIC`.** `^[0-9A-Za-z]{2,3}$`    | Recipient's state/province code.                                                                                                                                                                           |
|               | `country_code`   | String | **Required.** `^[A-Z]{3}$`. Must be a valid ISO country code                         | Recipient's country code (ISO 3166-1 alpha-2/3).                                                                                                                                                           |
| **sender**    | `first_name`     | String | **Required.** Max length: 30 characters                                              | Sender's (Payer) first name.                                                                                                                                                                               |
|               | `last_name`      | String | **Required.** Max length: 6 characters                                               | Sender's last name.                                                                                                                                                                                        |
|               | `birth`          | String | **Required.** Must be exactly 8 digits in YYYYMMDD format                            | Sender's date of birth.                                                                                                                                                                                    |
|               | `street`         | String | **Required.** Max length: 30 characters                                              | Sender's detailed address.                                                                                                                                                                                 |
|               | `city`           | String | **Required.** Max length: 25 characters                                              | Sender's city.                                                                                                                                                                                             |
|               | `state`          | String | **Required when `country_code` is `CAN`/`USA`/`COL`/`NIC`.** Length: 2\~3 characters | Sender's state/province code.                                                                                                                                                                              |
|               | `country_code`   | String | **Required.** Max length: 3 characters. Must be a valid ISO country code             | Sender's country code (ISO 3166-1 alpha-2/3).                                                                                                                                                              |

### Trimming Guidelines

If a field value exceeds the defined length limit, trimming is acceptable. This mainly applies to address-related fields such as street, state, and city.

Name fields are not expected to exceed the limit, but trimming is also acceptable in rare cases. If name fields are trimmed, please ensure the trimmed name for the same person remains consistent across all records.

## JSON Example

```json theme={null}
{
  "recipient_sender_details": {
    "fund_source": "01",
    "recipient": {
      "first_name": "John",
      "last_name": "Doe",
      "birth": "19900101",
      "account_number": "12345678",
      "postcode": "123456",
      "street": "123 Main Street",
      "city": "Singapore",
      "state": "01",
      "country_code": "SG"
    },
    "sender": {
      "first_name": "Jane",
      "last_name": "Smith",
      "birth": "19950505",
      "street": "456 Orchard Road",
      "city": "Singapore",
      "state": "03",
      "country_code": "SG"
    }
  }
}
```