Integrate crypto payments into your application with our RESTful API. Accept payments across multiple blockchains and receive USDC settlements automatically.
Sign up and get your API key from the merchant dashboard
Use the initiate endpoint to create a new payment invoice
Receive real-time payment confirmations via webhooks
All API requests require authentication using your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEYSecurity Note: Never expose your API key in client-side code. Always make API calls from your server.
/api/payment/initiateCreate new invoice from merchant dashboard
| Parameter | Type | Required | Description |
|---|---|---|---|
amount | number | Required | Amount in local currency |
currency | string | Required | Local currency code (NGN, USD, EUR) |
description | string | Optional | Payment description |
webhook_url | string | Optional | Callback URL for payment updates |
/api/payment/:refFetch invoice metadata for pay/:ref
| Parameter | Type | Required | Description |
|---|---|---|---|
ref | string | Required | Payment reference ID |
/api/payment/confirmManual confirmation with transaction hash
| Parameter | Type | Required | Description |
|---|---|---|---|
payment_ref | string | Required | Payment reference ID |
tx_hash | string | Required | Blockchain transaction hash |
chain | string | Required | Blockchain network (ethereum, starknet, polygon) |
token | string | Required | Token used for payment |
/api/payment/webhook/:merchantIdCallback to merchant on payment success
| Parameter | Type | Required | Description |
|---|---|---|---|
merchantId | string | Required | Merchant identifier |
/api/prices/:tokenGet current token price in various currencies
| Parameter | Type | Required | Description |
|---|---|---|---|
token | string | Required | Token symbol (USDC, ETH, DAI, MATIC) |
currencies | string | Optional | Comma-separated currency codes |
/api/ratesList all supported tokens and their conversion rates
No parameters required
EgyptFi sends webhook notifications to your specified URL when payment events occur. Configure your webhook URL in the merchant dashboard or when creating a payment.
Security: Always verify webhook signatures using the provided secret key to ensure authenticity.
Requests per minute
Requests per hour
Requests per day