Skip to main content

Bhutan Payments Developer Docs

Welcome to the Bhutan Payments API documentation. Use these guides to accept one-time payments, set up recurring subscriptions, and receive real-time event notifications via webhooks.

What you can do​

  • Payment API — Accept one-time payments through a hosted checkout experience. Customers are redirected to a secure checkout page and back to your site after payment.

  • Recurring Payments API — Create and manage subscription billing. Customers save a payment method once, and Bhutan Payments automatically charges them on the schedule you define.

  • Webhooks — Receive real-time HTTP notifications when payments succeed, fail, get disputed, or when subscriptions change state.

Base URLs​

EnvironmentURL
Productionhttps://api.bhutanpayments.com
Staginghttps://api-staging.bhutanpayments.com

Authentication​

All API requests require an API key in the X-API-Key header. Generate keys from the Bhutan Payments dashboard under Settings → API Keys.

X-API-Key: your_api_key
Content-Type: application/json

Encryption​

Sensitive request payloads are AES-encrypted. Each API key has an associated secret key used for encryption. See the Payment API encryption section for full details.

Sample Code​

A working Node.js integration example is available on GitHub:

checkout-nodejs-sample

git clone https://github.com/beyul/checkout-nodejs-sample.git