Transfers Overview
Everything you need to know about transfers on the Dots platform.
A transfer is a collection of transactions on the Dots platform representing a movement of funds. There are three types of transfers: balance, payout and refill. A balance transfer is a transfer of funds between an app’s wallet and a user’s wallet. A payout transfer is a transfer of funds from a user’s account to their external account. A refill transfer is a transfer of funds from a bank account to a user’s wallet.
A transfer can only be created between a user’s wallet and your app’s wallet in both directions. User to User transfers aren’t directly allowed. To create a payout, you must call the /payouts
endpoint.
The Transfer Object
Example
{
"id": "47b40e06-883d-44d1-b96c-8272195907a7",
"created": "2019-01-01T00:00:00.000Z",
"user_id": "76b40e06-883d-44d1-a96c-827219591231",
"status": "created",
"type": "balance",
"amount": 10000,
"transactions": [
{
"id": 12341,
"amount": 10000,
"created": "2019-01-01T00:00:00.000Z",
"source_name": "App",
"destination_name": "User",
"metadata": {}
}
],
"metadata": {}
}