PayEurasia Payment API

REST API for creating payments, verifying status, and processing refunds. Base URL: https://paycore.app

Authentication

Every request must include your API key and secret as headers:

X-Api-Key: pk_live_xxxxxxxxxxxxxxxxxxxx
X-Api-Secret: sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Create and manage keys in your Merchant → API Keys page. Never expose your secret in client-side code.

Request signing (recommended)

For sensitive endpoints you can additionally send an HMAC signature. Compute HMAC-SHA256(secret, "{timestamp}.{body}") in lowercase hex.

X-Timestamp: 1719238400
X-Signature: 9af34c1e8b...

Rate limits & IP whitelist

Limit: 120 req/min/merchant. If you configure an IP whitelist in Merchant → Security, requests from other IPs return 403 ip_not_allowed.

Enterprise Checkout Flow

Let your customer pick the wallet (bKash / Nagad / Rocket / Upay) on your own website, then pass that selection as payment_method. PayEurasia opens the dedicated wallet interface directly — no method-selection screen, faster conversion, fewer drop-offs.

Supported methods
bkash · nagad · rocket · upay
Customer Transaction ID
bKash: 10 alphanumeric chars · Nagad: 8 alphanumeric chars. First accepted TxID is final — subsequent submissions are rejected.
// 1. Customer selects "bKash" on your site
// 2. You call Create Payment with payment_method: "bkash"
POST /api/v1/payment/create
{ "invoice_id": "INV-1001", "amount": 2500, "currency": "BDT",
  "payment_method": "bkash",
  "customer_name": "Karim", "customer_phone": "+8801711000000" }

// 3. Redirect the customer to payment.checkout_url
//    → hosted bKash interface opens directly (no selector)
// 4. Customer pays and submits TxID → we verify with the provider
// 5. You receive payment.success webhook
POST
/api/v1/payment/create
Create Payment (Enterprise Checkout)

Create a payment intent. Pass `payment_method` to open the dedicated wallet interface directly (bKash/Nagad/Rocket/Upay) — the customer skips the method-selection screen. Supported values: `bkash`, `nagad`, `rocket`, `upay`. Omit `payment_method` for the legacy selector flow.

curl -X POST https://paycore.app/api/v1/payment/create \
  -H "X-Api-Key: pk_live_xxxx" \
  -H "X-Api-Secret: sk_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
  "invoice_id": "INV-1001",
  "amount": 2500,
  "currency": "BDT",
  "customer_name": "Karim Rahman",
  "customer_phone": "+8801711000000",
  "customer_email": "karim@example.com",
  "payment_method": "bkash",
  "metadata": {
    "order_id": "ORD-42"
  }
}'
POST
/api/v1/payment/verify
Verify Payment

Confirm a payment after the customer completes checkout. Credits the merchant balance on success.

curl -X POST https://paycore.app/api/v1/payment/verify \
  -H "X-Api-Key: pk_live_xxxx" \
  -H "X-Api-Secret: sk_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
  "invoice_id": "INV-1001",
  "transaction_id": "BKS123456789",
  "status": "success"
}'
GET
/api/v1/payment/status/{invoice_id}
Payment Status

Look up the current status of a payment.

curl https://paycore.app/api/v1/payment/status/{invoice_id} \
  -H "X-Api-Key: pk_live_xxxx" \
  -H "X-Api-Secret: sk_xxxx"
POST
/api/v1/refund/request
Request Refund

Submit a refund request against a successful payment. Goes to admin queue.

curl -X POST https://paycore.app/api/v1/refund/request \
  -H "X-Api-Key: pk_live_xxxx" \
  -H "X-Api-Secret: sk_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
  "invoice_id": "INV-1001",
  "amount": 2500,
  "reason": "Customer requested cancellation"
}'
GET
/api/v1/refund/status/{refund_id}
Refund Status

Check the status of a refund request.

curl https://paycore.app/api/v1/refund/status/{refund_id} \
  -H "X-Api-Key: pk_live_xxxx" \
  -H "X-Api-Secret: sk_xxxx"
GET
/api/v1/balance
Account Balance

Returns available, reserved and pending-settlement balances for the merchant.

curl https://paycore.app/api/v1/balance \
  -H "X-Api-Key: pk_live_xxxx" \
  -H "X-Api-Secret: sk_xxxx"
GET
/api/v1/settlements
List Settlements

Recent settlements (most recent first). Query: ?limit=50.

curl https://paycore.app/api/v1/settlements \
  -H "X-Api-Key: pk_live_xxxx" \
  -H "X-Api-Secret: sk_xxxx"
GET
/api/v1/transactions
List Transactions

Recent transactions. Query: ?limit=50&status=success.

curl https://paycore.app/api/v1/transactions \
  -H "X-Api-Key: pk_live_xxxx" \
  -H "X-Api-Secret: sk_xxxx"
POST
/api/v1/webhook/test
Test Webhook

Send a synthetic event to your configured webhook URL for end-to-end verification.

curl -X POST https://paycore.app/api/v1/webhook/test \
  -H "X-Api-Key: pk_live_xxxx" \
  -H "X-Api-Secret: sk_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
  "event": "test.ping",
  "data": {
    "hello": "world"
  }
}'

Webhooks

PayEurasia sends a POST to your configured webhook URL on these events: payment.success, payment.failed, refund.processed, settlement.paid. Verify the X-REBORNPAY-Signature HMAC header using your API secret.

POST https://your-site.com/webhooks/paycore
Content-Type: application/json
X-REBORNPAY-Signature: sha256=<hex>

{
  "event": "payment.success",
  "data": {
    "invoice_id": "INV-1001",
    "transaction_id": "BKS123456789",
    "amount": 2500,
    "currency": "BDT"
  }
}

Errors

CodeHTTPMeaning
missing_credentials401No X-Api-Key/X-Api-Secret
invalid_credentials401Wrong key or secret
merchant_not_approved403Account pending approval
invalid_body400Validation failed (see details)
duplicate_invoice_id409An invoice with that ID already exists
payment_not_found404No payment matches