curl --request POST \
--url https://api.sandbox.busha.so/v1/payments/links \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "invoice",
"fixed": true,
"one_time": true,
"name": "Invoice for Consulting Services",
"title": "Consulting Services - March 2024",
"description": "Payment for consulting services rendered",
"target_currency": "USDC",
"target_amount": "500.00",
"customer_email": "client@example.com",
"customer_name": "John Doe",
"due_date": "2024-04-15T00:00:00Z",
"note": "Thank you for your business!",
"items": [
{
"item": "Consulting Hours",
"quantity": 10,
"amount": "40.00"
},
{
"item": "Documentation Fee",
"quantity": 1,
"amount": "100.00"
}
]
}
'{
"status": "success",
"message": "Payment link created successfully",
"data": {
"id": "PAYL_abc123xyz",
"profile_id": "PROF_user123",
"type": "invoice",
"fixed": true,
"one_time": true,
"link": "https://pay.busha.io/charges/PAYL_abc123xyz",
"name": "Invoice for Consulting Services",
"title": "Consulting Services - March 2024",
"description": "Payment for consulting services rendered",
"target_currency": "USDC",
"target_amount": "500.00",
"meta": {
"customer_email": "client@example.com",
"customer_name": "John Doe",
"due_date": "2024-04-15T00:00:00Z",
"note": "Thank you for your business!",
"items": [
{
"item": "Consulting Hours",
"quantity": 10,
"amount": "40.00"
},
{
"item": "Documentation Fee",
"quantity": 1,
"amount": "100.00"
}
]
},
"status": "active",
"created_at": "2024-03-10T12:00:00Z",
"updated_at": "2024-03-10T12:00:00Z"
}
}PaymentLinks
Create a payment link
Create a payment link
POST
/
v1
/
payments
/
links
curl --request POST \
--url https://api.sandbox.busha.so/v1/payments/links \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "invoice",
"fixed": true,
"one_time": true,
"name": "Invoice for Consulting Services",
"title": "Consulting Services - March 2024",
"description": "Payment for consulting services rendered",
"target_currency": "USDC",
"target_amount": "500.00",
"customer_email": "client@example.com",
"customer_name": "John Doe",
"due_date": "2024-04-15T00:00:00Z",
"note": "Thank you for your business!",
"items": [
{
"item": "Consulting Hours",
"quantity": 10,
"amount": "40.00"
},
{
"item": "Documentation Fee",
"quantity": 1,
"amount": "100.00"
}
]
}
'{
"status": "success",
"message": "Payment link created successfully",
"data": {
"id": "PAYL_abc123xyz",
"profile_id": "PROF_user123",
"type": "invoice",
"fixed": true,
"one_time": true,
"link": "https://pay.busha.io/charges/PAYL_abc123xyz",
"name": "Invoice for Consulting Services",
"title": "Consulting Services - March 2024",
"description": "Payment for consulting services rendered",
"target_currency": "USDC",
"target_amount": "500.00",
"meta": {
"customer_email": "client@example.com",
"customer_name": "John Doe",
"due_date": "2024-04-15T00:00:00Z",
"note": "Thank you for your business!",
"items": [
{
"item": "Consulting Hours",
"quantity": 10,
"amount": "40.00"
},
{
"item": "Documentation Fee",
"quantity": 1,
"amount": "100.00"
}
]
},
"status": "active",
"created_at": "2024-03-10T12:00:00Z",
"updated_at": "2024-03-10T12:00:00Z"
}
}Authorizations
Bearer Authentication
Headers
User profile header
Example:
"BUS_YOK8tp5Zga01qOKEsqp07"
Body
application/json
A valid currency
Required string length:
1 - 10Example:
"BTC"
Optional. Derived from fixed/one_time if not provided
Available options:
payment_link, invoice decimal value
Example:
"100"
A valid currency
Required string length:
1 - 10Example:
"BTC"
decimal value
Example:
"100"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Required when type is invoice
Required when type is invoice
Optional due date for invoice (must be in the future)
Optional note for invoice (max 250 characters)
Maximum string length:
250Line items for invoice type payment links
Show child attributes
Show child attributes
if true, will not create a payment transfer