Direct API Integration

There are 2 steps involved in creating a transaction via API on Basqet.

• Step 1: Initializing the transaction
• Step 2: Initiating the Transaction

Initialize Transaction API

API Details

Action: Initialize Transaction
Method: POST
Path: /v1/transaction
Auth Requirement: Public/Private Key

Business Summary

This endpoint serves as the entry point for processing payments through Basqet. It creates a transaction object which can be initiated to collect payments from your customers. Once initialized, this object provides the necessary reference and structure to proceed.

You can use this API to:

• Send your customer's details to Basqet to generate a unique transaction record before they pay.
• Use the resulting transaction ID to provide your customer with the specific wallet address and payment info they need to complete their crypto transfer.

Request Parameters

Query Parameters

Request Headers

Request Examples

cURL

curl \--request POST \

  --url <https://api.basqet.com/v1/transaction> \

  --header 'Authorization: Bearer pub\_live\_xxxxxxxxxxxxx' \

  --header 'Content-Type: application/json' \

--data '{
"customer": {

  "name": "Test User",

  "email": "[email protected]"

},

"currency": "USD",

"amount": "1000.00",

"description": "Test Transaction \#001",

"meta": {

  "test\_mode": true,

  "cart\_id": "999"

}
 }'

Response Schema

Sample Response

"status": "success",  
  "data": {  
    "id": "BASQET\_TXN\_REF\_12345",  
    "reference": "BASQET\_TXN\_REF\_12345",  
    "amount\_paid": null,  
    "status": "INITIATED",  
    "description": "Invoice \#1024",  
    "initialized\_amount": 1500,  
    "payment\_amount": null,  
    "payment\_address": null,  
    "payment\_currency": null,  
    "initialized\_currency": 1,  
    "is\_live": true,  
    "merchant": {  
      "id": 10,  
      "name": "Acme Store"  
    }  
  },  
  "meta": {  
    "order\_id": "order\_1024",  
    "channel": "web"  
  }  
}

Error Reference

Notes

• public_key in the body and Authorization: Bearer pub_... are interchangeable for this endpoint.
• Sending Authorization: Bearer sec_... currently does not create a transaction successfully because the controller still looks up the key as a public key.

Webhook Payload

When a transaction is initialized, we make a POST request to your webhook URL. This is the format of the webhook payload you will receive:

{
  "event": "payment.initiated",
  "data": {
    "transaction": {
      "reference": "bq_B09BMmXXgWMzRSmon",
      "merchant_name": "Appstate",
      "payment_currency": null,
      "payment_currency_name": null,
      "payment_currency_slug": null,
      "status": "INITIATED",
      "customer_email": "[email protected]",
      "customer_name": "tunde",
      "payment_amount": null,
      "amount_paid": null,
      "description": null,
      "is_live": false,
      "created_at": "2022-07-14T20:17:11.000Z",
      "meta": {}
    }
  }
}

Initiate Transaction API

API Details

Action: Initiate Transaction
Method: POST
Path: /v1/transaction/:transaction_id/pay
Auth Requirement: None

Business Summary

This endpoint updates the transaction object by assigning a cryptocurrency to it and returning the calculated value and a payment address assigned to it.

You can use this API to:

• Select the specific cryptocurrency the customer wants to use to convert an INITIATED transaction into a live payment request.
• Transition the transaction to the PENDING state to generate a unique wallet address and a QR code for the customer.
• Lock in the real-time conversion rate to determine the exact amount of crypto the customer needs to send.

Request Parameters

Path Parameters

Query Parameters

Request Headers

Request Examples

cURL

curl --request POST \

--url https://api.basqet.com/v1/transaction/BASQET\_TXN\_REF\_12345/pay \

--header 'Content-Type: application/json' \

--data '{

"currency\_id": 2,

"refund\_address": "0x4f3edf983ac636a65a842ce7c78d9aa706d3b113"

}'

Response Schema

Sample Response

{
"status": "success",
"data": {
"qrCode": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
"id": "BASQET_TXN_REF_12345",
"reference": "BASQET_TXN_REF_12345",
"amount_paid": null,
"status": "PENDING",
"description": "Invoice #1024",
"initialized_amount": 1500,
"payment_amount": 0.002357,
"payment_address": "bc1qexampleaddress",
"payment_currency": "BTC",
"initialized_currency": "USD",
"is_live": true,
"merchant": {
"id": 10,
"name": "Acme Store"
}
},
"meta": {}
}

Error reference

Webhook Payload

Payment Pending (payment.pending)

When a transaction has been initiated and is awaiting payment, we make a POST request to your webhook URL (as set up in your dashboard). This is the format of the webhook payload you will receive:

{
"event": "payment.pending",
"data": {
"transaction": {
"reference": "bq_B09BMmXXgWMzRSmon",
"merchant_name": "Appstate",
"payment_currency": 6,
"payment_currency_name": "Ethereum",
"payment_currency_slug": "ETH",
"status": "PENDING",
"customer_email": "[email protected]",
"customer_name": "tunde",
"payment_amount": 0.001366,
"amount_paid": null,
"description": null,
"is_live": false,
"created_at": "2022-07-14T20:17:11.000Z",
"meta": {}
}
}
}

Payment Completed (payment.received)

When a transaction is successfully completed and the merchant has received payment, we make a POST request to your webhook URL (as set up in your dashboard). This is the format of the webhook payload you will receive:

{
"event": "payment.received",
"data": {
"transaction": {
"reference": "bq_RkaUV0Zy3PGpQsT8c",
"merchant_name": "Bar BQ Express",
"payment_currency": 3,
"payment_currency_name": "Bitcoin",
"payment_currency_slug": "BTC",
"status": "SUCCESSFUL",
"customer_email": "[email protected]",
"customer_name": "John Doe",
"payment_amount": 1,
"amount_paid": 1,
"description": "Payment for Lamborghini",
"is_live": false,
"created_at": "2026-02-09T16:18:20.000Z",
"meta": {}
}
}
}

Payment Abandoned (payment.abandoned)

When a transaction has been abandoned by the customer (e.g., the checkout session expires), we make a POST request to your webhook URL (as set up in your dashboard). This is the format of the webhook payload you will receive:

{
"event": "payment.abandoned",
"data": {
"transaction": {
"reference": "bq_B09BMmXXgWMzRSmon",
"merchant_name": "Appstate",
"payment_currency": 6,
"payment_currency_name": "Ethereum",
"payment_currency_slug": "ETH",
"status": "ABANDONED",
"customer_email": "[email protected]",
"customer_name": "tunde",
"payment_amount": 0.001366,
"amount_paid": null,
"description": null,
"is_live": false,
"created_at": "2022-07-14T20:17:11.000Z",
"meta": {}
}
}
}

Verify Transaction

Verify Transaction API

API Details

Action: Verify Transaction
Method: GET
Path: /v1/transaction/:transaction_id/status
Auth Requirement: Public or Secret Key (Bearer Auth)

Business Summary

This endpoint verifies the current status of a transaction using its unique transaction ID. It returns the latest transaction details, allowing you to check the current state of the customer's transaction.