Retrieve or create the current banking user BTC topup address

POST

/api/v2/merchants/payins/btc_topup

const url = 'https://core.example.com/api/v2/merchants/payins/btc_topup';
const options = {method: 'POST', headers: {'session-token': '<session-token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://core.example.com/api/v2/merchants/payins/btc_topup \
  --header 'session-token: <session-token>'

The route is in the merchant namespace but is actually called by the banking client.

Authorizations

SessionToken

Responses

200

BTC address data from the gateway

application/json

object

success

required

boolean

status

required

integer

Example

{
  "success": true,
  "status": 200
}

403

Authorization, validation, or business-rule error

application/json

object

success

required

boolean

status

required

integer

errors

required

One of:

Array<object>

object

code

string

kind

string

nullable

expiration

string

nullable

session

string

nullable

key

additional properties

any

key

additional properties

any

Example

{
  "success": false,
  "status": 403
}