DuitDigitalDocs Buka Console →
MERCHANT REST API · v1.0

Build financial workflows
without guesswork.

Dokumentasi publik DuitDigital untuk integrasi payment gateway, checkout, payment link, PPOB, SMM, OTP, refund, dan laporan transaksi merchant.

Mulai integrasi Download OpenAPI
create-payment.sh
curl https://api.duitdigital.id/v1/merchant/payments \
  -u "$DD_PUBLIC_KEY:$DD_SECRET_KEY" \
  -H "Idempotency-Key: order-2026-001" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "INV-2026-001",
    "amount": "100000",
    "currency": "IDR",
    "channel": "QRIS",
    "customer": {
      "name": "Customer",
      "email": "customer@example.com"
    }
  }'
QUICKSTART

Integrasi dalam tiga langkah

1

Buat workspace

Daftarkan akun dan buat merchant workspace melalui aplikasi. Test API key dapat dibuat langsung dari Developer Center.

2

Gunakan idempotency

Setiap operasi finansial mutasi wajib memakai Idempotency-Key unik agar retry jaringan tidak menghasilkan transaksi ganda.

3

Verifikasi webhook

Validasi signature HMAC, timestamp, event ID, dan ownership resource sebelum memperbarui status pada sistem Anda.

AUTHENTICATION

Autentikasi server-to-server

Integrasi Merchant API memakai HTTP Basic berisi scoped public key dan secret key. Kredensial dibuat serta dikelola melalui Developer Center.

  • Jangan simpan secret key di browser atau aplikasi mobile.
  • Gunakan test key selama development.
  • Batasi scope dan IP whitelist untuk live key.
Merchant API Authorization: Basic base64(public:secret) Environment Gunakan test atau live key sesuai kebutuhan
ERROR MODEL

Respons konsisten dan dapat ditindaklanjuti

{
  "success": false,
  "error": {
    "code": "PAYMENT_CHANNEL_UNAVAILABLE",
    "message": "Payment channel is unavailable",
    "fields": {}
  },
  "meta": { "request_id": "req_..." }
}

HTTP status

401 Kredensial invalid atau expired

403 Scope API key ditolak

409 Konflik state, idempotency, atau provider

422 Validasi input gagal

429 Rate limit terlampaui

PUBLIC API REFERENCE

20 endpoint Merchant API

Daftar publik hanya mencakup kontrak integrasi server-to-server untuk merchant. API admin, portal, autentikasi pengguna, callback provider, hosted frontend, dan operasional sistem tidak dipublikasikan.

Memuat detail Merchant API…