Transfer Crypto by Phone Number

This guide explains how to transfer cryptocurrency from your wallet using the recipient's phone number.

Step 1. Check the recipient's phone number

Endpoint:

GET /reg/v1/user/search

Use this endpoint to check if the recipient's phone number belongs to a registered app user. The phone number must be in international format (for example, a Spanish user's number: +34 123 456 789).

❗️
The plus sign (+) in the country code must be encoded as %2B

Query Parameters:

Name	Type	Required	Description
`phone`	`string`	➖	The intended cryptocurrency recipient's phone number.

If the phone number is correct and belongs to an existing user, the system will return a 200 OK response. Otherwise, in case the specified phone number is not associated with any app user account, you'll get the 404 error message.

Step 2. Transfer crypto to another user's wallet

Endpoint:

POST /wallet/withdraw

Use this endpoint to submit a withdrawal request.

Query Parameters:

Name	Type	Required	Description
`dryRun`	`boolean`	➖	This parameter allows to check resulting rate and fee amount without executing any operation. If `true`, the API simulates the operation without executing it. This allows you to preview all the details before committing. The actual operation will only proceed if `dryRun` is omitted or explicitly set to `false`.
`autoConversion`	`boolean`	➖	Enables automatic currency conversion.

Body Parameters:

Field	Type	Required	Description
`currency`	`string`	✅	The currency in which the transfer is made.
`amount`	`string`	✅	The amount of currency to transfer.
`type`	`string`	✅	The type of withdrawal: `CRYPTO_BY_PHONE`.
`fromAccount`	`string`	✅	Identifies the `CHECKING` type of account initiating the transfer. All accounts can be retrieved using List all accounts endpoint.
`blockchain`	`string`	➖	Blockchain name.
`to`	`string`	➖	The phone number of the recipient in international format (for example, a Spanish user's number: +34 123 456 789).

Response Example:

   {
  "id": "4fbf6d17-19fc-4a83-a6b6-efc657eac75b",
  "currency": "usdc",
  "amount": 20.0,
  "type": "CRYPTO_BY_PHONE",
  "meta": {
    "internal": true,
    "phone": "+3584573993096",
    "availableBalance": "9590.950000000000000000",
    "public_note": "Withdraw is waiting for approval"
  },
  "fromAccount": "4125b459-42de-41f9-9c2e-3dd3f5b5f739",
  "feeAmount": 0.06,
  "status": "PENDING",
  "to": "+3584573993096",
  "blockchain": "eth",
  "iban": null,
  "bicOrSwiftCode": null,
  "createdAt": null,
  "updatedAt": null
}

📘
Remarks

All withdrawals require email confirmation. A verification email will be sent upon successful API call and will be valid for 30 minutes.

To get the min/max withdrawal limits and related fees, use the Get All Currencies endpoint.

When performing a cryptocurrency transfer, the recipient's phone number will also be checked for presence in the database.

Updated 7 days ago