# Transfer Object

A transfer is single money movement between account inside the platform

```json
{
  "uuid": "8uh7-n332-9vst-l2c1",
  "referenceId": "[your_reference]",
  "recipientId": "u734-981324saf-53tu",
  "amount": 100000,
  "remarks": "transfer for coffeeshop",
  "transferType": "DIRECT",
  "status": "SUCCESS",
  "transaction_timestamp": "2024-05-13T08:21:44.967496538Z",
  "created": "2024-05-13T08:21:44.967496538Z",
  "updated": "2024-05-13T08:21:44.967496538Z"
}
```

### Transfer Object Schema

<table data-full-width="true"><thead><tr><th width="275">Schema Path</th><th width="170">Specs and Validation</th><th>Description</th></tr></thead><tbody><tr><td><strong>uuid</strong></td><td><ul><li>String</li></ul></td><td>Object Unique Identifier</td></tr><tr><td><strong>referenceId</strong></td><td><ul><li>String</li><li>Required</li></ul></td><td>Merchant Reference Id from the Client's System </td></tr><tr><td><strong>recipientId</strong></td><td><ul><li>String</li><li>Required</li></ul></td><td>UUID of the Recipient, recipient can be a merchant for platform case or a customer for wallet case</td></tr><tr><td><strong>amount</strong></td><td><ul><li>Number</li><li>Required</li></ul></td><td>Transfer amount</td></tr><tr><td><strong>remarks</strong></td><td><ul><li>String</li><li>Required</li></ul></td><td>Transfer note or remarks from the Client's System</td></tr><tr><td><strong>transferType</strong></td><td></td><td></td></tr><tr><td><strong>status</strong></td><td><ul><li>ENUM</li><li>Generated</li></ul></td><td>Transfer Status, one of <code>SUCCESS</code>, <code>PENDING</code> and <code>FAILED</code></td></tr><tr><td><strong>transactionTimestamp</strong></td><td><ul><li>String</li><li>Generated</li></ul></td><td>Transfer transaction timestamp</td></tr><tr><td><strong>created</strong></td><td><ul><li>String</li><li>Generated</li></ul></td><td>Transfer Object created time in ISO-8601 Format. i.e. 2024-05-13T08:21:44.967496538Z</td></tr><tr><td><strong>updated</strong></td><td><ul><li>String</li><li>Generated</li></ul></td><td>Transfer Object last updated time in ISO-8601 Format. i.e. 2024-05-13T08:21:44.967496538Z</td></tr></tbody></table>