POST
/
api
/
v1
/
withdrawals
curl --request POST \
  --url https://sandbox-b2b.ripio.com/api/v1/withdrawals/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "end_user": "customer_10",
  "currency": "BTC",
  "address": "0x36f672385c060290f4785F1ECFF58aE4aBB2FD15",
  "network": "BITCOIN_TESTNET",
  "amount": 1.5,
  "external_ref": "ac243840-ac04-4b3a-9efb-176554d4a029",
  "withdrawal_fee_id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "created_at": "2019-08-24T14:15:22Z",
  "confirmation_date": "2019-08-25T14:15:22Z",
  "txn_hash": "0x0923990f2j7cb207d3766e75730e8426d2fb3b6e896914f80a61943b1a8f29d2",
  "end_user_id": "customer_10",
  "currency": "ETH",
  "amount": 0.002,
  "address": "0x36f672385c060290f4785F1ECFF58aE4aBB2FD15",
  "charged_fee": 0,
  "network_name": "BITCOIN",
  "status": "PENDING"
}

Authorizations

​
Authorization
string
header
required

B2B’s White Label API uses OAuth2. Currently there is only one supported authentication flow:

  • clientCredentials allows you to access your own B2B account (First-Party Integration) and performs transactions against the public API. This oauth2 flow is well suited for this API, as it allows machine-to-machine communication.

Every call to the API has to be authenticated with an OAuth2 Token. In order to request this token, you will need to have sandbox or production API Keys (client id and client secret) that will be needed to generate a credential in order to negotiate an ephemeral access token.

Every request must be accompianed by an Authorization header with a value that follows the following schema: Bearer ACCESS_TOKEN

Body

​
end_user
string

End use's external ref

​
currency
string

Currency of the amount to be withdrwaled

​
address
string

Destination address

​
network
string

Blockchain network to operate

​
amount
number

Amount to withdrawal. Is the amount that the destination address will receive.

​
external_ref
string

An external identifier, usually a unique UUID

​
withdrawal_fee_id
string

Indicates the withdrawal fee id to use in order to define the applied fees on this withdrawal.

Response

201 - application/json
Created
​
id
string

UUID used as withdrawal identifier.

​
created_at
string

Indicates the withdrawal request creation date.

​
confirmation_date
string | null

Identifies the withdrawal confirmation date.

​
txn_hash
string

Indicates the hash of the blockchain transaction, once completed.

​
end_user_id
string

Identifies the user that owns this operation.

​
currency
string

Indicates the asset name involved in the withdrawal.

​
amount
number

Indicates the amount withdrawed.

​
address
string

Identifies the destination address.

Maximum length: 128
​
charged_fee
number

Indicates the fee amount charged for the withdrawal.

​
network_name
enum<string>
Available options:
BITCOIN,
ETHEREUM
​
status
string

Specifies the withdrawal status.

Was this page helpful?