> For the complete documentation index, see [llms.txt](https://pivot-payment.gitbook.io/pivot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/account-and-balance/transfer/create-a-transfer.md).

# Create a Transfer

Single - One way money movement between platform accounts

## Method and URL

<mark style="color:green;">`POST`</mark> \[<mark style="color:orange;">BASE\_URL</mark>]/v1/transfers

## Request

**Request Body**

```json
{
    "referenceId": "PAY/trf-0109332",
    "recipientId": "u734-981324saf-53tup",
    "transferType": "DIRECT",
    "amount": 10000,
    "remarks": "transfer for coffeeshop"
}
```

**Detail Parameter Request**

<table><thead><tr><th width="176">Parameter</th><th>Data Type</th><th>Character limit</th><th width="134.3984375">Requirement</th><th width="283">Description</th></tr></thead><tbody><tr><td>referenceId</td><td>String</td><td>1-100</td><td>M</td><td>Id of transaction reference from merchant, It can be used for reconcile process</td></tr><tr><td>recipientId</td><td>Uuid</td><td>-</td><td>M</td><td>Id of the Recipient, in platform cases means merchantId</td></tr><tr><td>transferType</td><td>String</td><td>0-20</td><td>M</td><td>Posibble value is <mark style="color:orange;"><code>DIRECT</code></mark></td></tr><tr><td>amount</td><td>Numeric</td><td>-</td><td>M</td><td>Transfer amount</td></tr><tr><td>remarks</td><td>String</td><td>1-100</td><td>M</td><td>Note for the transaction</td></tr></tbody></table>

## Response

**Response Body**

{% code fullWidth="false" %}

```json
{
    "code": "00",
    "message": "Success",
    "data": {
        "uuid": "8uh7-n332-9vst-l2c1",
        "recipientId": "u734-981324saf-53tu",
        "amount": 10000,
        "remarks": "transfer for coffeeshop",
        "status": "SUCCESS",
        "transaction_timestamp": "2024-05-13T08:21:44.967496538Z",
        "created": "2024-05-13T08:21:44.967496538Z",
        "updated": "2024-05-13T08:21:44.967496538Z"
    }
}
```

{% endcode %}

**Detail Parameter Response**

<table><thead><tr><th>Parameter</th><th width="121.150390625">Data Type</th><th width="135.8369140625">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>code</td><td>String</td><td>M</td><td>Response Code from Pivot</td></tr><tr><td>message</td><td>String</td><td>M</td><td>Human readable message that represent response from Pivot</td></tr><tr><td>data</td><td>Object</td><td>M</td><td>Response Data from Pivot contains <a data-mention href="/pivot-docs/api-references/api-lists/account-and-balance/transfer/transfer-object.md">Transfer Object</a></td></tr></tbody></table>