API Documentation
Connect your stablecoin or wallet platform to the BridgiPay merchant network. RESTful API with instant settlement and real-time webhooks.
https://api.bridgipay.com/v1Overview
Initiate a stablecoin payment between a customer wallet and merchant.
Retrieve status and details of a specific transaction by ID.
Query active merchants with filtering by location and industry.
Register a new merchant and generate their QR payment endpoint.
Retrieve settlement details including amounts and yield earned.
Subscribe to real-time events for transaction and settlement updates.
Authentication
All API requests require a valid API key passed via the Authorization header.
// Include in all requests
Authorization: Bearer bp_live_sk_xxxxxxxxxxxx
// Test environment
Authorization: Bearer bp_test_sk_xxxxxxxxxxxxUse test keys for sandbox development and live keys for production.
Endpoints
Create a new stablecoin payment transaction. Returns a QR code payload and transaction ID.
| Field | Type | Description |
|---|---|---|
| merchant_id* | string | The merchant receiving payment |
| amount* | number | Payment amount in USD |
| currency* | string | USDC, USDT, or PYUSD |
| wallet_provider | string | Preferred wallet |
| metadata | object | Custom key-value pairs |
POST /v1/transactions
{
"merchant_id": "mrc_00482",
"amount": 24.50,
"currency": "USDC",
"wallet_provider": "coinbase"
}{
"id": "txn_9f8e7d6c5b4a",
"status": "pending",
"qr_payload": "bridgipay://pay?txn=...",
"expires_at": "2026-03-03T15:30:00Z"
}Retrieve current status and full details of a transaction.
| Field | Type | Description |
|---|---|---|
| status | string | pending, confirmed, settled, or expired |
| amount | number | Transaction amount in USD |
| settled_at | string | ISO 8601 settlement timestamp |
| settlement_time_ms | number | Time to settlement in milliseconds |
Subscribe to real-time events for transaction lifecycle updates.
| Event | Description |
|---|---|
| transaction.confirmed | Payment confirmed on-chain |
| transaction.settled | Funds delivered to merchant |
| transaction.expired | Payment window expired |
| settlement.daily | Daily settlement summary |
| merchant.activated | Merchant activated and live |
SDKs
npm install @bridgipay/sdkpip install bridgipaygo get bridgipay.com/sdkgem install bridgipayGet API access and start connecting your platform to the BridgiPay merchant network.
Request API Access