# Create a Transfer Request

### Method and URL

<mark style="color:green;">`POST`</mark> | <mark style="color:orange;">`[BASE_URL]`</mark>`/v1/transfers`

### Request

#### Example Body Request Payload

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

#### Request Body Schema

<table><thead><tr><th width="176">Schema Path</th><th width="283">Description</th><th>Specifications</th></tr></thead><tbody><tr><td><strong>referenceId</strong></td><td>Id of transaction reference from merchant, It can be used for reconcile process</td><td><ul><li>Required</li><li>Limited Special Character Allowed</li></ul></td></tr><tr><td><strong>recipientId</strong></td><td>Id of the Recipient, in platform cases means merchantId</td><td><ul><li>Required</li></ul></td></tr><tr><td><strong>amount</strong></td><td>Transfer amount</td><td><ul><li>Required</li></ul></td></tr><tr><td><strong>remarks</strong></td><td>Note for the transaction</td><td><ul><li>Required</li></ul></td></tr></tbody></table>

### Response

#### Example Response Body

{% code fullWidth="true" %}

```json
{
    "code": "string",
    "message": "string",
    "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 %}

#### **Response Data Schema**

<table><thead><tr><th width="151">Schema Path</th><th width="362">Description</th><th>Data Type Validation</th></tr></thead><tbody><tr><td><strong>code</strong></td><td>Response Code from Harsya</td><td>String</td></tr><tr><td><strong>message</strong></td><td>Human readable message that represent response from Harsya</td><td>String</td></tr><tr><td><strong>data</strong></td><td>Response Data from Harsya contains <a href="../transfer-object#transfer-object-schema">Transfer Object</a></td><td>Object</td></tr></tbody></table>