Create a Transfer

Testing Env

https://partner-api-stage.p100.io

POST

/v1/transfer

This endpoint allows you to initiate a transfer of funds between a user and the partner account. The partner's balance is always involved: if sourceExternalUserId is provided, funds move from the user to the partner; if destinationExternalUserId is provided, funds move from the partner to the user. Direct user-to-user transfers are not supported. The request must specify the amount and currency, and at least one of the user IDs. After the request is accepted, the transfer is scheduled for processing asynchronously. Use the Get Transfer Details endpoint to track the final status and outcome, including any errors such as insufficient funds or invalid parameters.

Business logic errors (such as insufficient funds) are not checked at this stage. Processing occurs asynchronously. Use the Get Transfer Details endpoint to verify the final status and any errors.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/json

Examples

Responses

🟢201Created

application/json

Body

🟠401Access Denied

🟠400P403: Validation error

🟠400P412: User not exist

🟠400P424: Source or destination must be provided

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

🟠400P459: User not verified

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://partner-api-stage.p100.io/v1/transfer' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "destinationExternalUserId": "75a1d530-3c12-44e8-a23a-0241b9e73c87",
    "amount": "1",
    "currency": "doge"
}'

Response Example

201 - Success

{
    "transferId": "082768b4-c831-47fb-920b-fea0d8d51be0"
}

Internal Transfers

Get Transfer Details