> For the complete documentation index, see [llms.txt](https://docs.pagsmile.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagsmile.com/reference/payout/submit-a-payout/tajikistan/banktransfer.md).

# Banktransfer

Use the Pagsmile Payout API to send funds to an eligible payment card held by an individual beneficiary in Tajikistan. The beneficiary receives the payout in USD.

### Endpoint

<mark style="color:green;">`POST`</mark> [`https://sandbox.transfersmile.com/api/payout`](https://sandbox.transfersmile.com/api/payout)

### Headers

<table><thead><tr><th width="157.8359375">Header</th><th width="90.78125">Type</th><th width="110.62109375">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>Content-Type</code></td><td>string</td><td>Yes</td><td>Fixed value: <code>application/json; charset=UTF-8</code>.</td></tr><tr><td><code>AppId</code></td><td>string</td><td>Yes</td><td>Your 32-character App ID in the Pagsmile Payout platform.</td></tr><tr><td><code>Authorization</code></td><td>string</td><td>Yes</td><td>Request signature generated using <code>SHA256($sorted_params + $app_key)</code>.</td></tr></tbody></table>

### Request body

<table><thead><tr><th width="176.59375">Parameter</th><th>Type</th><th>Required</th><th>Constraints</th><th>Description</th></tr></thead><tbody><tr><td><code>name</code></td><td>string</td><td>Yes</td><td>Must contain 2–100 characters and be a valid beneficiary name.</td><td>Full name of the cardholder.</td></tr><tr><td><code>account_type</code></td><td>string</td><td>Yes</td><td>Fixed value: <code>CREDITCARD_NO</code>.</td><td>Type of beneficiary account.</td></tr><tr><td><code>account</code></td><td>string</td><td>Yes</td><td>Must contain exactly 16 digits.</td><td>Eligible beneficiary card number.</td></tr><tr><td><code>document_type</code></td><td>string</td><td>Yes</td><td>Fixed value: <code>individual</code> (case-insensitive).</td><td>Type of beneficiary receiving the payout.</td></tr><tr><td><code>fee_bear</code></td><td>string</td><td>Yes</td><td>One of: <code>merchant</code> or <code>beneficiary</code>.</td><td>Party responsible for the payout fee.</td></tr><tr><td><code>amount</code></td><td>decimal string</td><td>Yes</td><td>Minimum: <code>0.01</code>; maximum: <code>10000</code>. Up to 2 decimal places.</td><td>Payout amount, denominated according to <code>amount_type</code>.</td></tr><tr><td><code>amount_type</code></td><td>string</td><td>No</td><td>One of: <code>arrival_amount</code> or <code>source_amount</code>. Defaults to <code>arrival_amount</code>.</td><td>Specifies whether <code>amount</code> is fixed on the beneficiary side or the merchant funding side.</td></tr><tr><td><code>source_currency</code></td><td>string</td><td>Yes</td><td>One of: <code>USD</code>, <code>GBP</code>, or <code>EUR</code>. The selected currency must be enabled for the merchant.</td><td>Currency used to fund the payout.</td></tr><tr><td><code>arrival_currency</code></td><td>string</td><td>Yes</td><td>Fixed value: <code>USD</code>.</td><td>Currency received by the beneficiary.</td></tr><tr><td><code>notify_url</code></td><td>string</td><td>Yes</td><td>Must be a valid URL and must not exceed 255 characters.</td><td>Merchant endpoint that receives payout status notifications.</td></tr><tr><td><code>custom_code</code></td><td>string</td><td>Yes</td><td>Must be unique for the merchant and must not exceed 50 characters.</td><td>Merchant payout reference.</td></tr><tr><td><code>additional_remark</code></td><td>string</td><td>Yes</td><td>Must contain 4–40 characters. Only letters, numbers, spaces, and underscores are accepted.</td><td>Additional information about the payout.</td></tr><tr><td><code>country</code></td><td>string</td><td>Yes</td><td>Fixed value: <code>TJK</code>.</td><td>ISO 3166-1 alpha-3 country code for Tajikistan.</td></tr><tr><td><code>method</code></td><td>string</td><td>Yes</td><td>Fixed value: <code>BANKTRANSFER</code>.</td><td>Payout method.</td></tr></tbody></table>

### Request sample

```json
{
  "name": "Ga********ya",
  "account_type": "CREDITCARD_NO",
  "account": "50********88",
  "document_type": "individual",
  "fee_bear": "merchant",
  "amount": "0.05",
  "source_currency": "USD",
  "arrival_currency": "USD",
  "notify_url": "https://merchant.example.com/payout/notify",
  "custom_code": "custom_code33********",
  "additional_remark": "banktransfer payout request",
  "country": "TJK",
  "method": "BANKTRANSFER"
}
```

### Response sample

```json
{
  "code": 200,
  "msg": "success",
  "time": 1787638308,
  "data": {
    "id": "TS2026********",
    "custom_code": "custom_code33********",
    "arrival_amount": "0.05",
    "arrival_currency": "USD",
    "source_amount": "0.06",
    "source_currency": "USD",
    "status": "IN_PROCESSING"
  }
}
```

{% hint style="warning" %}
A successful API response means that the payout request has been accepted for processing. Use payout notifications or the payout-status query API to determine the final result.
{% endhint %}