Built for developers

Connect once. Build the experience you need.

The BiliPay developer layer exposes documented APIs, API keys, webhooks and a developer environment. Live provider connectivity is enabled only after verification.

REST API

Predictable, resource-oriented endpoints for payment intents, links and invoices.

API keys

Separate test and production keys with scoped, revocable access.

Webhooks

Signed events with replay awareness and idempotent processing.

Test environment

A safe environment to build and test before any live activation.

Reference docs

Request/response examples for every supported operation.

Error model

Consistent error codes so integrations can fail predictably.

api.bilipay.live

POST /api/v1/payment-intents

{
  "amount": 4850,
  "currency": "BDT",
  "reference": "ORDER-1024",
  "return_url": "https://example.com/return"
}

→ 201 Created
→ payment_intent_id
→ checkout_url

Developer portal preview

Endpoints, events and keys in one place.

API reference

Planned endpoints

POST/v1/payment-intentsCreate a payment intent

GET/v1/payment-intents/:idRetrieve intent status

POST/v1/payment-linksCreate a shareable payment link

POST/v1/invoicesIssue a structured payment request

GET/v1/eventsList webhook events

Webhook event (example)

{
  "type": "payment_intent.succeeded",
  "id": "evt_evt_0001",
  "created": 1750000000,
  "data": { "reference": "ORDER-1024" }
}

Signature verification and idempotency are part of the planned delivery model.

API keys & security

Test and production keys stay separate.

Secrets are server-side only, never in the browser.

Keys are scoped, rotatable and revocable.

bp_test_key_••••••••••••••••

No real credentials are issued on this page.

Ready to build with BiliPay?

Merchant onboarding and developer access roll out in controlled phases.

Become a Merchant