Reference

The full API surface.

Every resource MerasPay exposes — across direct payments, bulk disbursement, remittance termination, agent network, hosted checkout, billing, and partner integrations. All endpoints accept JSON, are versioned by date header, and require an Idempotency-Key on every write.

ℹ

Conventions

Base URL: https://api.merashub.com. Auth: Authorization: Bearer sk_test_... (secret) or pk_test_... (publishable, browser-safe). Versioning: MerasPay-Version: 2026-05-25. Idempotency: pass Idempotency-Key on every POST — same key in the next 24h returns the same response. Amounts: amount_minor integer in minor units (DJF is zero-decimal; pass integer DJF).

Direct API · accept payments

Charge a customer wallet or bank account from your backend. The Stripe-equivalent surface, adapted to Djibouti rails.

Payment Intents →

Create + confirm a single charge. Backed by every Djibouti rail through one shape.

POSTGETconfirmcancel

Payment Methods →

Tokenise cards, mobile wallets, bank accounts into pm_ tokens.

POSTGETdetach

Refunds →

Reverse a charge — partial or full. Settles on the originating rail.

POSTGET

Customers →

Persistent payer profile — attach payment methods + history.

POSTGET

Balance →

Your float across currencies and accounts (pending, available, reserved).

GET

Money movement

Push money out to wallets, bank accounts, payroll lists, or other merchants on the network.

Payouts & bulk disbursement →

B2C disbursements — single payout, or a batch payroll/salary run with one upload.

POSTbulkB2C

Transfers (B2B) →

Inter-merchant transfers — atomic, Connect-style, with application_fee + transfer_data.

POSTB2B

Hosted Checkout →

Drop-in branded payment page on checkout.merashub.com. Zero PCI, multi-rail.

session

QR codes →

EMVCo merchant-presented QR — static or dynamic, any compliant wallet can scan.

EMVCo MPM

Partners

Higher-volume integrations: licensed remittance operators terminating into Djibouti, and the field agent network.

Remittance operators →

For licensed MTOs: lock an FX quote, originate a remittance, terminate at a wallet/bank/agent.

quoteordertermination

Agent network →

Cash-in / cash-out kiosks with float, commissions, geo-fencing.

collectcashout

Commerce

Recurring revenue, invoicing, and chargeback handling.

Billing & subscriptions →

Products, prices, invoices, subscriptions, coupons, tax rates — the full Stripe-equivalent commerce surface.

productssubscriptions

Disputes →

Chargeback lifecycle: open, submit evidence, win/lose. Stripe-shaped.

evidence

Reference

Cross-cutting topics — credential management, event delivery, error envelope.

Keys & credentials →

API keys (sk_/pk_), RSA keypairs, webhook signing secrets — all the credential management endpoints.

sk_pk_RSA

Webhooks · event catalog →

Event types, HMAC signing, retry schedule, replay protection.

HMACretry

Try one in 30 seconds

Mint a sk_test_… key from your merchant portal, then:

curl · create a sandbox PaymentIntentbash

curl -X POST https://api.merashub.com/v1/payment_intents \
  -H "Authorization: Bearer sk_test_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 50000, "currency": "DJF", "provider": "mock" }'