Payment

Making an authenticated call to the payment endpoint

Get a new blockchain address

Bloqifi allows privacy minded users the ability to generate a new address using the API.

If users prefer to pay with balance, Bloqifi protect your privacy by generating a new address every time funds is received.

Create address

GET https://api.bloqifi.com/v0/payment/:BLOCKCHAIN

Create a new receiving address

Headers

Name	Type	Description
Content-Type*	String	application/json
Authorization*	String	Bearer ${accessToken}

200: OK

{
    address: address
}

503: Service Unavailable

{
    message: `Payment with ${blockchain} unavailable at the moment..`
}

curl

curl -X POST https://api.bloqifi.com/v0/payment/${blockchain} \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${TOKEN}"

JavaScript

const rawResponse = await fetch(`https://api.bloqifi.com/v0/payment/${blockchain}`, {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`
  }
});

const json = await rawResponse.json();

if (rawResponse.status === 200) {
  return json.address;
}

Good to know: Note that all old used addresses are discarded by Bloqifi.

Do not send funds to any old address generated by Bloqifi.

Generate payment request

Get payment request for storage / website using bloq ObjectId from previous step.

Get Payment Request

POST https://api.bloqifi.com/v0/payment

Get a new payment request

Headers

Name	Type	Description
Content-Type*	String	application/json
Authorization*	String	Bearer ${accessToken}

Request Body

Name	Type	Description
blockchain*	String	Bloqcoin, Dogecoin, Bitcoin, IPFS
ids*	Array	List of ids ['123', '321']

402: Payment Required

{
	message: `${blockchain} waiting for transfer`,
	amount: 0.01,
	address: 'address'
}

503: Service Unavailable

{
	message: `Payment with ${blockchain} unavailable at the moment.`
}

Cancel Order

Cancel the payment, and remove any added bloqs, folders, chunk entries etc.

Cancel order

DELETE https://api.bloqifi.com/v0/payment

Cancel generated payment request

Headers

Name	Type	Description
Content-Type*	String	application/json
Authorization*	String	Bearer ${accessToken}

Request Body

Name	Type	Description
address*	String	Generated blockchain address

200: OK

{
	message: 'Payment cancelled.'
}

Good to know: This endpoint only affects bloq's with a status of 402 Payment Required