Integrasi API

​

1. Buat API Key

1. Buka Developer API di dashboard.
2. Generate key. Secret lengkap hanya ditampilkan sekali.
3. Kirim di setiap request: Authorization: Bearer ktd_live_…

​

2. Base URL

# Produksi
https://api.kawan.digital/v1

​

3. List produk, lalu buat order

export API_KEY="ktd_live_..."
export API="https://api.kawan.digital/v1"

curl -sS "$API/products" \
  -H "Authorization: Bearer $API_KEY"

curl -sS "$API/payment-methods" \
  -H "Authorization: Bearer $API_KEY"

curl -sS -X POST "$API/orders" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "buyer": {
      "name": "Budi",
      "email": "budi@example.com",
      "phone": "081234567890"
    },
    "items": [{ "type": "product", "product_id": "PRODUCT_UUID" }],
    "payment_method": "duitku:qris",
    "success_url": "https://yoursite.com/thanks"
  }'

• payment_url — link pembayaran Duitku. Untuk UI sendiri pakai JSON payment, atau checkout_url untuk halaman bayar Kawan.
• Transfer bank penjual — rekening dan nominal ada di payment.seller_bank.
• Setelah lunas, pembeli diarahkan ke success_url (jika dikirim) plus query ?order=…. Return dari gateway bisa masih pending — sumber kebenaran adalah webhook order.paid.

​

4. Webhook

​

5. Limit & error

• 60 request / menit per API key
• 10 create-order / menit per key
• Limit terlampaui: 429 RATE_LIMITED + header Retry-After