Create Payment
POST
/v0/payments
Creates a new cryptocurrency payment request. This endpoint generates a crypto payment address for your customer to send funds to and initiates payment tracking.
Request Parameters
| Parameter | Type | Description |
|---|---|---|
| amount_usd required | number | The payment amount in USD. Will be converted to the equivalent cryptocurrency amount based on daily exchange rates. |
| blockchain required | string | The blockchain network to use for the payment. Options: ETH, BSC, BTC, TRX |
| callback_url optional | string | A URL that will receive payment status updates via webhooks. Must be a valid HTTPS URL. |
| custom_id optional | string | Your custom identifier for this payment (e.g., an order number). Max 64 characters. |
Example Request
POST /v0/payments
Content-Type: application/json
X-API-Key: your_api_key_here
{
"amount_usd": 100.00,
"blockchain": "ETH",
"callback_url": "https://your-site.com/payment/callback",
"custom_id": "ORDER-12345"
}
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| payment_id | string | Unique identifier for the payment. Use this to check status or reference the payment. |
| crypto_amount | number | The amount of cryptocurrency to be paid, calculated based on daily exchange rates. |
| address | string | The cryptocurrency address where funds should be sent. |
| expiry_time | string | ISO 8601 timestamp indicating when the payment request expires. |
| token | string | The cryptocurrency token to be used for payment (USDT, or BTC for Bitcoin network). |
| blockchain | string | The blockchain network being used (ETH, BSC, BTC, or TRX). |
Example Response
{
"error": "deprecated_endpoint",
"message": "This API endpoint is deprecated in v0.9 and no longer functional. Please use the v1.0 API endpoints instead.",
"request_id": "req_v09_deprecated"
}
Error Codes
| Status Code | Error Code | Description |
|---|---|---|
| 400 | invalid_request | The request was malformed or contained invalid parameters. |
| 401 | authentication_failed | Authentication failed. Check your API key. |
| 410 | deprecated_endpoint | This endpoint is deprecated in v0.9 and no longer functional. Please use the v1.0 API. |
| 422 | unsupported_blockchain | The specified blockchain is not supported in v0.9 (only ETH, BSC, BTC, and TRX are supported). |
| 429 | rate_limit_exceeded | You have exceeded the rate limit for payment creation. |
| 500 | payment_provider_error | An error occurred with the payment processor. Contact support if this persists. |
Notes
Important: This API endpoint is deprecated in v0.9 and will always return an error response. Please upgrade to the v1.0 API for current functionality.
- This endpoint is no longer functional in v0.9 as the API has been deprecated.
- All requests to this endpoint will receive the error response shown above.
- To continue using the Cryptofuse API, please upgrade to the v1.0 API endpoints.