{"openapi":"3.1.1","info":{"title":"Bisadagang Bisnis H2H API","version":"1.0.0","description":"API H2H (host-to-host) Bisadagang Bisnis menghubungkan sistem Mitra Bisnis ke produk digital Bisadagang, termasuk pulsa, paket data, token listrik, e-wallet, dan tagihan.\n\n### Production dan sandbox\n\nKedua environment memakai base URL yang sama. Production memakai saldo asli dan hanya menerima request dari IP yang ada di whitelist. Sandbox memakai saldo terpisah dan dapat digunakan dari IP mana saja ketika whitelist sandbox kosong.\n\nSandbox menggunakan katalog dan harga live, sementara transaksi berjalan sebagai simulasi dengan saldo terpisah. Hasil simulasi mengikuti empat digit terakhir nomor tujuan:\n\n- …0001 — Sukses langsung, dengan nomor serial (sn) simulasi.\n- …0002 — Gagal langsung. Saldo sandbox dikembalikan.\n- …0003 — Pending, lalu sukses sekitar 30 detik kemudian.\n- …0004 — Pending, lalu gagal sekitar 30 detik kemudian. Saldo sandbox dikembalikan saat gagal.\n- …0005 — Pending terus, tanpa status akhir.\n- …0006 — Inquiry tagihan mengembalikan INQUIRY_FAILED. Cek nama mengembalikan ACCOUNT_NOT_FOUND.\n\n### Signature request\n\n1. Tulis method HTTP dalam huruf besar.\n2. Ambil path dan query string persis seperti dikirim, termasuk encoding dan urutan query.\n3. Gunakan timestamp dan nonce yang sama dengan isi header.\n4. Hitung SHA-256 dari byte body yang dikirim dan ubah hasilnya ke hex huruf kecil. Untuk GET, hash body kosong.\n5. Gabungkan method, path dan query, timestamp, nonce, dan hash body dengan LF. Hitung HMAC-SHA256 dengan API secret sebagai kunci, lalu ubah hasilnya ke hex huruf kecil.\n\nUntuk request ber-body gunakan application/json. Buat timestamp, nonce, dan signature baru setiap kali mengulang request."},"servers":[{"url":"https://api.bisadagang.com/h2h/v1","description":"Production dan sandbox. Environment ditentukan oleh API key."}],"externalDocs":{"url":"https://bisnis.bisadagang.com/docs"},"security":[{"X-Bisadagang-Key":[],"X-Bisadagang-Timestamp":[],"X-Bisadagang-Nonce":[],"X-Bisadagang-Signature":[]}],"tags":[{"name":"Saldo dan produk"},{"name":"Transaksi"},{"name":"Komplain"},{"name":"Webhook"}],"paths":{"/balance":{"get":{"operationId":"getBalance","tags":["Saldo dan produk"],"summary":"Cek saldo","description":"Ambil saldo dalam rupiah untuk environment API key. Batas default 120 request per menit per Mitra Bisnis dan environment.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/saldo"},"responses":{"200":{"description":"Request berhasil.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"data":{"$ref":"#/components/schemas/Balance"},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","data","request_id"]}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"415":{"$ref":"#/components/responses/Error415"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"$ref":"#/components/responses/Error503"}}}},"/products":{"get":{"operationId":"listProducts","tags":["Saldo dan produk"],"summary":"Daftar harga dan produk","description":"Ambil katalog dan harga akun, termasuk produk yang sedang gangguan. Pilihan produk mengikuti environment API key. Batas default 120 request per menit per Mitra Bisnis dan environment.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/produk"},"parameters":[{"name":"category","in":"query","schema":{"type":"string","maxLength":100},"description":"Filter kategori. Huruf besar dan kecil diperlakukan sama."},{"name":"status","in":"query","schema":{"type":"string","enum":["normal","gangguan"]},"description":"Filter status produk."},{"name":"semua","in":"query","schema":{"type":"boolean","default":false},"description":"true menampilkan semua produk yang bisa dipilih, termasuk yang belum aktif."}],"responses":{"200":{"description":"Request berhasil.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"data":{"$ref":"#/components/schemas/Products"},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","data","request_id"]}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"415":{"$ref":"#/components/responses/Error415"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"$ref":"#/components/responses/Error503"}}}},"/transactions":{"post":{"operationId":"createTransaction","tags":["Transaksi"],"summary":"Buat transaksi prabayar","description":"Beli produk nominal tetap atau nominal bebas. Untuk nominal bebas, kirim amount dan account_check_id, lalu cek status atau gunakan webhook. Production biasanya mengembalikan pending. Sandbox bisa langsung final. Batas default 300 request per menit per Mitra Bisnis dan environment.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/transaksi#prabayar"},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTransaction"}}}},"responses":{"200":{"description":"Request berhasil.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"data":{"$ref":"#/components/schemas/Transaction"},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","data","request_id"]}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"404":{"description":"PRODUCT_NOT_FOUND — Produk tidak ditemukan atau tidak tersedia.","x-error-codes":["PRODUCT_NOT_FOUND"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/PRODUCT_NOT_FOUND"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"409":{"description":"REQUEST_IN_PROGRESS — Request dengan Idempotency-Key ini masih diproses.\n\nREF_ID_CONFLICT — ref_id sudah dipakai untuk transaksi dengan isi berbeda.","x-error-codes":["REQUEST_IN_PROGRESS","REF_ID_CONFLICT"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/REQUEST_IN_PROGRESS"},{"$ref":"#/components/schemas/REF_ID_CONFLICT"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"415":{"$ref":"#/components/responses/Error415"},"422":{"description":"PRODUCT_DISABLED — Produk tidak aktif untuk akun atau environment ini.\n\nPRODUCT_DISRUPTED — Produk sedang gangguan.\n\nPRODUCT_NOT_SUPPORTED — Produk tidak dapat digunakan di operasi ini.\n\nDESTINATION_BLOCKED — Nomor tujuan tidak dapat diproses.\n\nINSUFFICIENT_BALANCE — Saldo pada environment ini tidak mencukupi.\n\nIDEMPOTENCY_KEY_REUSED — Idempotency-Key digunakan dengan byte body yang berbeda.\n\nVALIDATION_ERROR — Parameter, header, atau body tidak valid.\n\nPRICE_CHANGED — Harga saat ini melebihi max_price.\n\nACCOUNT_CHECK_REQUIRED — Diperlukan cek nama yang masih berlaku untuk produk dan tujuan yang sama.\n\nDESTINATION_LIMIT_REACHED — Batas transaksi untuk tujuan ini tercapai.","x-error-codes":["PRODUCT_DISABLED","PRODUCT_DISRUPTED","PRODUCT_NOT_SUPPORTED","DESTINATION_BLOCKED","INSUFFICIENT_BALANCE","IDEMPOTENCY_KEY_REUSED","VALIDATION_ERROR","PRICE_CHANGED","ACCOUNT_CHECK_REQUIRED","DESTINATION_LIMIT_REACHED"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/PRODUCT_DISABLED"},{"$ref":"#/components/schemas/PRODUCT_DISRUPTED"},{"$ref":"#/components/schemas/PRODUCT_NOT_SUPPORTED"},{"$ref":"#/components/schemas/DESTINATION_BLOCKED"},{"$ref":"#/components/schemas/INSUFFICIENT_BALANCE"},{"$ref":"#/components/schemas/IDEMPOTENCY_KEY_REUSED"},{"$ref":"#/components/schemas/AMOUNT_VALIDATION_ERROR"},{"$ref":"#/components/schemas/PRICE_CHANGED"},{"$ref":"#/components/schemas/ACCOUNT_CHECK_REQUIRED"},{"$ref":"#/components/schemas/DESTINATION_LIMIT_REACHED"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"$ref":"#/components/responses/Error503"}}}},"/transactions/{ref_id}":{"get":{"operationId":"getTransaction","tags":["Transaksi"],"summary":"Cek status transaksi","description":"Ambil status terbaru transaksi prabayar atau pembayaran tagihan di environment API key. Batas default 120 request per menit per Mitra Bisnis dan environment.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/transaksi#cek-status"},"parameters":[{"name":"ref_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,50}$"},"description":"Referensi transaksi dari sistem Mitra Bisnis."}],"responses":{"200":{"description":"Request berhasil.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"data":{"$ref":"#/components/schemas/Transaction"},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","data","request_id"]}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"404":{"description":"NOT_FOUND — Objek tidak ditemukan di environment dan akun ini.","x-error-codes":["NOT_FOUND"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/NOT_FOUND"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"415":{"$ref":"#/components/responses/Error415"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"$ref":"#/components/responses/Error503"}}}},"/bills/inquiry":{"post":{"operationId":"inquireBill","tags":["Transaksi"],"summary":"Cek tagihan pascabayar","description":"Inquiry gratis, berlaku 30 menit. Inquiry yang belum dibayar untuk produk dan tujuan sama dapat dipakai ulang selama lima menit. Batas default 60 request per menit per Mitra Bisnis dan environment.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/transaksi#pascabayar"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDestination"}}}},"responses":{"200":{"description":"Request berhasil.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"data":{"$ref":"#/components/schemas/BillInquiry"},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","data","request_id"]}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"404":{"description":"PRODUCT_NOT_FOUND — Produk tidak ditemukan atau tidak tersedia.","x-error-codes":["PRODUCT_NOT_FOUND"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/PRODUCT_NOT_FOUND"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"415":{"$ref":"#/components/responses/Error415"},"422":{"description":"PRODUCT_DISABLED — Produk tidak aktif untuk akun atau environment ini.\n\nPRODUCT_DISRUPTED — Produk sedang gangguan.\n\nPRODUCT_NOT_SUPPORTED — Produk tidak dapat digunakan di operasi ini.\n\nINQUIRY_FAILED — Tidak ada tagihan yang bisa dibayar.","x-error-codes":["PRODUCT_DISABLED","PRODUCT_DISRUPTED","PRODUCT_NOT_SUPPORTED","INQUIRY_FAILED"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/PRODUCT_DISABLED"},{"$ref":"#/components/schemas/PRODUCT_DISRUPTED"},{"$ref":"#/components/schemas/PRODUCT_NOT_SUPPORTED"},{"$ref":"#/components/schemas/INQUIRY_FAILED"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"description":"SERVICE_MAINTENANCE — Layanan sedang dalam pemeliharaan atau gangguan.\n\nSUPPLIER_UNAVAILABLE — Penyedia belum memberi jawaban yang bisa digunakan.","x-error-codes":["SERVICE_MAINTENANCE","SUPPLIER_UNAVAILABLE"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/SERVICE_MAINTENANCE"},{"$ref":"#/components/schemas/SUPPLIER_UNAVAILABLE"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}}}}},"/bills/payment":{"post":{"operationId":"payBill","tags":["Transaksi"],"summary":"Bayar tagihan pascabayar","description":"Bayar inquiry satu kali sebelum kedaluwarsa. ref_id berbagi ruang dengan transaksi prabayar. Batas default 300 request per menit per Mitra Bisnis dan environment.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/transaksi#pascabayar"},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayBill"}}}},"responses":{"200":{"description":"Request berhasil.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"data":{"$ref":"#/components/schemas/Transaction"},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","data","request_id"]}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"404":{"description":"NOT_FOUND — Objek tidak ditemukan di environment dan akun ini.\n\nPRODUCT_NOT_FOUND — Produk tidak ditemukan atau tidak tersedia.","x-error-codes":["NOT_FOUND","PRODUCT_NOT_FOUND"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/NOT_FOUND"},{"$ref":"#/components/schemas/PRODUCT_NOT_FOUND"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"409":{"description":"REQUEST_IN_PROGRESS — Request dengan Idempotency-Key ini masih diproses.\n\nREF_ID_CONFLICT — ref_id sudah dipakai untuk transaksi dengan isi berbeda.","x-error-codes":["REQUEST_IN_PROGRESS","REF_ID_CONFLICT"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/REQUEST_IN_PROGRESS"},{"$ref":"#/components/schemas/REF_ID_CONFLICT"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"415":{"$ref":"#/components/responses/Error415"},"422":{"description":"PRODUCT_DISABLED — Produk tidak aktif untuk akun atau environment ini.\n\nPRODUCT_DISRUPTED — Produk sedang gangguan.\n\nPRODUCT_NOT_SUPPORTED — Produk tidak dapat digunakan di operasi ini.\n\nDESTINATION_BLOCKED — Nomor tujuan tidak dapat diproses.\n\nINSUFFICIENT_BALANCE — Saldo pada environment ini tidak mencukupi.\n\nIDEMPOTENCY_KEY_REUSED — Idempotency-Key digunakan dengan byte body yang berbeda.\n\nINQUIRY_EXPIRED — Inquiry kedaluwarsa atau tidak dapat dibayar.\n\nINQUIRY_ALREADY_PAID — Inquiry dibayar dengan ref_id lain.","x-error-codes":["PRODUCT_DISABLED","PRODUCT_DISRUPTED","PRODUCT_NOT_SUPPORTED","DESTINATION_BLOCKED","INSUFFICIENT_BALANCE","IDEMPOTENCY_KEY_REUSED","INQUIRY_EXPIRED","INQUIRY_ALREADY_PAID"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/PRODUCT_DISABLED"},{"$ref":"#/components/schemas/PRODUCT_DISRUPTED"},{"$ref":"#/components/schemas/PRODUCT_NOT_SUPPORTED"},{"$ref":"#/components/schemas/DESTINATION_BLOCKED"},{"$ref":"#/components/schemas/INSUFFICIENT_BALANCE"},{"$ref":"#/components/schemas/IDEMPOTENCY_KEY_REUSED"},{"$ref":"#/components/schemas/INQUIRY_EXPIRED"},{"$ref":"#/components/schemas/INQUIRY_ALREADY_PAID"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"$ref":"#/components/responses/Error503"}}}},"/account-check":{"post":{"operationId":"checkAccount","tags":["Transaksi"],"summary":"Cek nama rekening atau e-wallet","description":"Cek nama gratis. check_id berlaku selama 30 menit untuk produk dan tujuan yang sama. Batas default 60 request per menit per Mitra Bisnis dan environment.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/transaksi#cek-nama"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDestination"}}}},"responses":{"200":{"description":"Request berhasil.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"data":{"$ref":"#/components/schemas/AccountCheck"},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","data","request_id"]}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"404":{"description":"PRODUCT_NOT_FOUND — Produk tidak ditemukan atau tidak tersedia.","x-error-codes":["PRODUCT_NOT_FOUND"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/PRODUCT_NOT_FOUND"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"415":{"$ref":"#/components/responses/Error415"},"422":{"description":"PRODUCT_NOT_SUPPORTED — Produk tidak dapat digunakan di operasi ini.\n\nACCOUNT_NOT_FOUND — Nama pemilik tujuan tidak ditemukan.","x-error-codes":["PRODUCT_NOT_SUPPORTED","ACCOUNT_NOT_FOUND"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/PRODUCT_NOT_SUPPORTED"},{"$ref":"#/components/schemas/ACCOUNT_NOT_FOUND"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"description":"SERVICE_MAINTENANCE — Layanan sedang dalam pemeliharaan atau gangguan.\n\nSUPPLIER_UNAVAILABLE — Penyedia belum memberi jawaban yang bisa digunakan.","x-error-codes":["SERVICE_MAINTENANCE","SUPPLIER_UNAVAILABLE"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/SERVICE_MAINTENANCE"},{"$ref":"#/components/schemas/SUPPLIER_UNAVAILABLE"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}}}}},"/complaints":{"post":{"operationId":"createComplaint","tags":["Komplain"],"summary":"Ajukan komplain","description":"Ajukan komplain dalam tujuh hari setelah transaksi dibuat. Satu komplain aktif per transaksi. Transaksi gagal tidak memenuhi syarat. Batas tetap 60 request per menit per Mitra Bisnis dan environment.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/komplain#buat"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateComplaint"}}}},"responses":{"200":{"description":"Request berhasil.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"data":{"$ref":"#/components/schemas/Complaint"},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","data","request_id"]}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"404":{"description":"NOT_FOUND — Objek tidak ditemukan di environment dan akun ini.","x-error-codes":["NOT_FOUND"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/NOT_FOUND"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"409":{"description":"COMPLAINT_EXISTS — Transaksi sudah memiliki komplain aktif.","x-error-codes":["COMPLAINT_EXISTS"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/COMPLAINT_EXISTS"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"415":{"$ref":"#/components/responses/Error415"},"422":{"description":"COMPLAINT_NOT_ALLOWED — Status transaksi atau alasan tidak memenuhi syarat komplain.\n\nCOMPLAINT_WINDOW_CLOSED — Batas tujuh hari pengajuan komplain telah lewat.","x-error-codes":["COMPLAINT_NOT_ALLOWED","COMPLAINT_WINDOW_CLOSED"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/COMPLAINT_NOT_ALLOWED"},{"$ref":"#/components/schemas/COMPLAINT_WINDOW_CLOSED"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"$ref":"#/components/responses/Error503"}}},"get":{"operationId":"listComplaints","tags":["Komplain"],"summary":"Daftar komplain","description":"Daftar komplain pada environment API key, dengan paginasi cursor. Batas tetap 120 request per menit per Mitra Bisnis dan environment.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/komplain#daftar"},"parameters":[{"name":"status","in":"query","schema":{"type":"string","enum":["open","processing","resolved"]},"description":"Filter status komplain."},{"name":"ref_id","in":"query","schema":{"type":"string","maxLength":50},"description":"Filter referensi transaksi."},{"name":"transaction_id","in":"query","schema":{"type":"string","maxLength":64},"description":"Filter ID transaksi."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Jumlah komplain per halaman."},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":200},"description":"Gunakan next_cursor dari respons sebelumnya."}],"responses":{"200":{"description":"Request berhasil.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"data":{"$ref":"#/components/schemas/Complaints"},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","data","request_id"]}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"415":{"$ref":"#/components/responses/Error415"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"$ref":"#/components/responses/Error503"}}}},"/complaints/{complaint_id}":{"get":{"operationId":"getComplaint","tags":["Komplain"],"summary":"Cek detail komplain","description":"Ambil komplain beserta riwayat pesan. Batas tetap 120 request per menit per Mitra Bisnis dan environment.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/komplain#detail"},"parameters":[{"name":"complaint_id","in":"path","required":true,"schema":{"type":"string","maxLength":24},"description":"ID komplain dari Bisadagang."}],"responses":{"200":{"description":"Request berhasil.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"data":{"$ref":"#/components/schemas/Complaint"},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","data","request_id"]}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"404":{"description":"NOT_FOUND — Objek tidak ditemukan di environment dan akun ini.","x-error-codes":["NOT_FOUND"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/NOT_FOUND"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"415":{"$ref":"#/components/responses/Error415"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"$ref":"#/components/responses/Error503"}}}},"/complaints/{complaint_id}/messages":{"post":{"operationId":"replyComplaint","tags":["Komplain"],"summary":"Balas komplain","description":"Tambahkan pesan pada komplain open atau processing. Batas tetap 60 request per menit per Mitra Bisnis dan environment.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/komplain#balas"},"parameters":[{"name":"complaint_id","in":"path","required":true,"schema":{"type":"string","maxLength":24},"description":"ID komplain dari Bisadagang."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplyComplaint"}}}},"responses":{"200":{"description":"Request berhasil.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"data":{"$ref":"#/components/schemas/Complaint"},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","data","request_id"]}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"404":{"description":"NOT_FOUND — Objek tidak ditemukan di environment dan akun ini.","x-error-codes":["NOT_FOUND"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/NOT_FOUND"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"415":{"$ref":"#/components/responses/Error415"},"422":{"description":"COMPLAINT_CLOSED — Komplain sudah selesai.","x-error-codes":["COMPLAINT_CLOSED"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/COMPLAINT_CLOSED"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"$ref":"#/components/responses/Error503"}}}}},"webhooks":{"transaction.updated":{"post":{"operationId":"receiveTransactionUpdated","tags":["Webhook"],"summary":"transaction.updated","description":"Dikirim ke URL HTTPS yang didaftarkan untuk environment terkait. Verifikasi HMAC-SHA256 atas timestamp, titik, dan byte body mentah, lalu deduplikasi dengan event_id. Selain 2xx atau timeout memicu percobaan ulang, maksimal delapan pengiriman dalam sekitar 24 jam.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/webhook#verifikasi"},"security":[],"parameters":[{"name":"X-Bisadagang-Event","in":"header","required":true,"schema":{"const":"transaction.updated"},"description":"Jenis event, sama dengan field event."},{"name":"X-Bisadagang-Delivery","in":"header","required":true,"schema":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"description":"ID stabil yang sama dengan event_id, termasuk saat dikirim ulang."},{"name":"X-Bisadagang-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]{1,12}$"},"description":"Timestamp Unix dalam detik. Verifikasi toleransi 300 detik."},{"name":"X-Bisadagang-Signature","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{64}(,[0-9a-f]{64})?$"},"description":"Hex huruf kecil hasil HMAC-SHA256. Saat rotasi, dua signature dipisah koma. Terima jika salah satunya cocok secara constant-time."},{"name":"User-Agent","in":"header","required":true,"schema":{"const":"Bisadagang-Webhook/1.0"},"description":"Identitas pengirim HTTP."},{"name":"Content-Length","in":"header","required":true,"schema":{"type":"integer"},"description":"Ukuran body dalam byte. Media type body adalah application/json."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"event":{"const":"transaction.updated"},"environment":{"type":"string","enum":["production","sandbox"]},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","properties":{"transaction_id":{"type":"string"},"ref_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,50}$"},"product_code":{"type":"string","pattern":"^[A-Z0-9]{1,20}$"},"customer_no":{"type":"string","pattern":"^[0-9]{4,20}$"},"price":{"type":"number"},"status":{"type":"string","enum":["pending","success","failed"]},"sn":{"anyOf":[{"type":"string"},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["transaction_id","ref_id","product_code","customer_no","price","status","sn","message"]}},"required":["event_id","event","environment","created_at","data"]}}}},"responses":{"401":{"description":"Signature tidak cocok atau timestamp di luar toleransi."},"2XX":{"description":"Event diterima. Balas dalam 10 detik. Body respons tidak diperlukan."},"default":{"description":"Pengiriman dianggap gagal."}}}},"complaint.updated":{"post":{"operationId":"receiveComplaintUpdated","tags":["Webhook"],"summary":"complaint.updated","description":"Dikirim ke URL HTTPS yang didaftarkan untuk environment terkait. Verifikasi HMAC-SHA256 atas timestamp, titik, dan byte body mentah, lalu deduplikasi dengan event_id. Selain 2xx atau timeout memicu percobaan ulang, maksimal delapan pengiriman dalam sekitar 24 jam.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/webhook#verifikasi"},"security":[],"parameters":[{"name":"X-Bisadagang-Event","in":"header","required":true,"schema":{"const":"complaint.updated"},"description":"Jenis event, sama dengan field event."},{"name":"X-Bisadagang-Delivery","in":"header","required":true,"schema":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"description":"ID stabil yang sama dengan event_id, termasuk saat dikirim ulang."},{"name":"X-Bisadagang-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]{1,12}$"},"description":"Timestamp Unix dalam detik. Verifikasi toleransi 300 detik."},{"name":"X-Bisadagang-Signature","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{64}(,[0-9a-f]{64})?$"},"description":"Hex huruf kecil hasil HMAC-SHA256. Saat rotasi, dua signature dipisah koma. Terima jika salah satunya cocok secara constant-time."},{"name":"User-Agent","in":"header","required":true,"schema":{"const":"Bisadagang-Webhook/1.0"},"description":"Identitas pengirim HTTP."},{"name":"Content-Length","in":"header","required":true,"schema":{"type":"integer"},"description":"Ukuran body dalam byte. Media type body adalah application/json."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"event":{"const":"complaint.updated"},"environment":{"type":"string","enum":["production","sandbox"]},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","properties":{"complaint_id":{"type":"string"},"transaction_id":{"type":"string"},"ref_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,50}$"},"status":{"type":"string","enum":["open","processing","resolved"]},"result":{"anyOf":[{"type":"string","enum":["success","failed"]},{"type":"null"}]},"message":{"anyOf":[{"type":"object","properties":{"from":{"type":"string","enum":["team","system"]},"text":{"type":"string"},"created_at":{"type":"string","format":"date-time"}},"required":["from","text","created_at"]},{"type":"null"}]}},"required":["complaint_id","transaction_id","ref_id","status","result","message"]}},"required":["event_id","event","environment","created_at","data"]}}}},"responses":{"401":{"description":"Signature tidak cocok atau timestamp di luar toleransi."},"2XX":{"description":"Event diterima. Balas dalam 10 detik. Body respons tidak diperlukan."},"default":{"description":"Pengiriman dianggap gagal."}}}},"product.auto_disabled":{"post":{"operationId":"receiveProductAutoDisabled","tags":["Webhook"],"summary":"product.auto_disabled","description":"Dikirim ke URL HTTPS yang didaftarkan untuk environment terkait. Verifikasi HMAC-SHA256 atas timestamp, titik, dan byte body mentah, lalu deduplikasi dengan event_id. Selain 2xx atau timeout memicu percobaan ulang, maksimal delapan pengiriman dalam sekitar 24 jam.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/webhook#verifikasi"},"security":[],"parameters":[{"name":"X-Bisadagang-Event","in":"header","required":true,"schema":{"const":"product.auto_disabled"},"description":"Jenis event, sama dengan field event."},{"name":"X-Bisadagang-Delivery","in":"header","required":true,"schema":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"description":"ID stabil yang sama dengan event_id, termasuk saat dikirim ulang."},{"name":"X-Bisadagang-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]{1,12}$"},"description":"Timestamp Unix dalam detik. Verifikasi toleransi 300 detik."},{"name":"X-Bisadagang-Signature","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{64}(,[0-9a-f]{64})?$"},"description":"Hex huruf kecil hasil HMAC-SHA256. Saat rotasi, dua signature dipisah koma. Terima jika salah satunya cocok secara constant-time."},{"name":"User-Agent","in":"header","required":true,"schema":{"const":"Bisadagang-Webhook/1.0"},"description":"Identitas pengirim HTTP."},{"name":"Content-Length","in":"header","required":true,"schema":{"type":"integer"},"description":"Ukuran body dalam byte. Media type body adalah application/json."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"event":{"const":"product.auto_disabled"},"environment":{"const":"production"},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","properties":{"product_code":{"type":"string","pattern":"^[A-Z0-9]{1,20}$"},"product_name":{"type":"string"},"category":{"type":"string"},"success_rate":{"type":"number"},"threshold":{"type":"number"},"transactions":{"type":"integer"},"min_transactions":{"type":"integer"},"disabled_at":{"type":"string","format":"date-time"}},"required":["product_code","product_name","category","success_rate","threshold","transactions","min_transactions","disabled_at"]}},"required":["event_id","event","environment","created_at","data"]}}}},"responses":{"401":{"description":"Signature tidak cocok atau timestamp di luar toleransi."},"2XX":{"description":"Event diterima. Balas dalam 10 detik. Body respons tidak diperlukan."},"default":{"description":"Pengiriman dianggap gagal."}}}},"product.auto_enabled":{"post":{"operationId":"receiveProductAutoEnabled","tags":["Webhook"],"summary":"product.auto_enabled","description":"Dikirim ke URL HTTPS yang didaftarkan untuk environment terkait. Verifikasi HMAC-SHA256 atas timestamp, titik, dan byte body mentah, lalu deduplikasi dengan event_id. Selain 2xx atau timeout memicu percobaan ulang, maksimal delapan pengiriman dalam sekitar 24 jam.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/webhook#verifikasi"},"security":[],"parameters":[{"name":"X-Bisadagang-Event","in":"header","required":true,"schema":{"const":"product.auto_enabled"},"description":"Jenis event, sama dengan field event."},{"name":"X-Bisadagang-Delivery","in":"header","required":true,"schema":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"description":"ID stabil yang sama dengan event_id, termasuk saat dikirim ulang."},{"name":"X-Bisadagang-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]{1,12}$"},"description":"Timestamp Unix dalam detik. Verifikasi toleransi 300 detik."},{"name":"X-Bisadagang-Signature","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{64}(,[0-9a-f]{64})?$"},"description":"Hex huruf kecil hasil HMAC-SHA256. Saat rotasi, dua signature dipisah koma. Terima jika salah satunya cocok secara constant-time."},{"name":"User-Agent","in":"header","required":true,"schema":{"const":"Bisadagang-Webhook/1.0"},"description":"Identitas pengirim HTTP."},{"name":"Content-Length","in":"header","required":true,"schema":{"type":"integer"},"description":"Ukuran body dalam byte. Media type body adalah application/json."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"event":{"const":"product.auto_enabled"},"environment":{"const":"production"},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","properties":{"product_code":{"type":"string","pattern":"^[A-Z0-9]{1,20}$"},"product_name":{"type":"string"},"category":{"type":"string"},"success_rate":{"type":"number"},"threshold":{"type":"number"},"enabled_at":{"type":"string","format":"date-time"}},"required":["product_code","product_name","category","success_rate","threshold","enabled_at"]}},"required":["event_id","event","environment","created_at","data"]}}}},"responses":{"401":{"description":"Signature tidak cocok atau timestamp di luar toleransi."},"2XX":{"description":"Event diterima. Balas dalam 10 detik. Body respons tidak diperlukan."},"default":{"description":"Pengiriman dianggap gagal."}}}},"product.created":{"post":{"operationId":"receiveProductCreated","tags":["Webhook"],"summary":"product.created","description":"Dikirim ke URL HTTPS yang didaftarkan untuk environment terkait. Verifikasi HMAC-SHA256 atas timestamp, titik, dan byte body mentah, lalu deduplikasi dengan event_id. Selain 2xx atau timeout memicu percobaan ulang, maksimal delapan pengiriman dalam sekitar 24 jam.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/webhook#verifikasi"},"security":[],"parameters":[{"name":"X-Bisadagang-Event","in":"header","required":true,"schema":{"const":"product.created"},"description":"Jenis event, sama dengan field event."},{"name":"X-Bisadagang-Delivery","in":"header","required":true,"schema":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"description":"ID stabil yang sama dengan event_id, termasuk saat dikirim ulang."},{"name":"X-Bisadagang-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]{1,12}$"},"description":"Timestamp Unix dalam detik. Verifikasi toleransi 300 detik."},{"name":"X-Bisadagang-Signature","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{64}(,[0-9a-f]{64})?$"},"description":"Hex huruf kecil hasil HMAC-SHA256. Saat rotasi, dua signature dipisah koma. Terima jika salah satunya cocok secara constant-time."},{"name":"User-Agent","in":"header","required":true,"schema":{"const":"Bisadagang-Webhook/1.0"},"description":"Identitas pengirim HTTP."},{"name":"Content-Length","in":"header","required":true,"schema":{"type":"integer"},"description":"Ukuran body dalam byte. Media type body adalah application/json."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"event":{"const":"product.created"},"environment":{"type":"string","enum":["production","sandbox"]},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","properties":{"total":{"type":"integer","minimum":1,"maximum":100},"products":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Z0-9]{1,20}$"},"product_name":{"type":"string"},"category":{"type":"string"},"brand":{"type":"string"},"type":{"type":"string"},"product_type":{"type":"string","enum":["prepaid","postpaid"]},"is_open_amount":{"type":"boolean"},"status":{"type":"string","enum":["normal","gangguan"]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"fee":{"anyOf":[{"type":"number"},{"type":"null"}]},"admin_fee":{"anyOf":[{"type":"number"},{"type":"null"}]},"commission":{"anyOf":[{"type":"number"},{"type":"null"}]},"active":{"type":"boolean"}},"required":["code","product_name","category","brand","type","product_type","is_open_amount","status","price","fee","admin_fee","commission","active"]},"minItems":1,"maxItems":100}},"required":["total","products"]}},"required":["event_id","event","environment","created_at","data"]}}}},"responses":{"401":{"description":"Signature tidak cocok atau timestamp di luar toleransi."},"2XX":{"description":"Event diterima. Balas dalam 10 detik. Body respons tidak diperlukan."},"default":{"description":"Pengiriman dianggap gagal."}}}},"price.changed":{"post":{"operationId":"receivePriceChanged","tags":["Webhook"],"summary":"price.changed","description":"Dikirim ke URL HTTPS yang didaftarkan untuk environment terkait. Verifikasi HMAC-SHA256 atas timestamp, titik, dan byte body mentah, lalu deduplikasi dengan event_id. Selain 2xx atau timeout memicu percobaan ulang, maksimal delapan pengiriman dalam sekitar 24 jam.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/webhook#verifikasi"},"security":[],"parameters":[{"name":"X-Bisadagang-Event","in":"header","required":true,"schema":{"const":"price.changed"},"description":"Jenis event, sama dengan field event."},{"name":"X-Bisadagang-Delivery","in":"header","required":true,"schema":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"description":"ID stabil yang sama dengan event_id, termasuk saat dikirim ulang."},{"name":"X-Bisadagang-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]{1,12}$"},"description":"Timestamp Unix dalam detik. Verifikasi toleransi 300 detik."},{"name":"X-Bisadagang-Signature","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{64}(,[0-9a-f]{64})?$"},"description":"Hex huruf kecil hasil HMAC-SHA256. Saat rotasi, dua signature dipisah koma. Terima jika salah satunya cocok secara constant-time."},{"name":"User-Agent","in":"header","required":true,"schema":{"const":"Bisadagang-Webhook/1.0"},"description":"Identitas pengirim HTTP."},{"name":"Content-Length","in":"header","required":true,"schema":{"type":"integer"},"description":"Ukuran body dalam byte. Media type body adalah application/json."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"event":{"const":"price.changed"},"environment":{"type":"string","enum":["production","sandbox"]},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","properties":{"total":{"type":"integer","minimum":1,"maximum":100},"products":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Z0-9]{1,20}$"},"product_name":{"type":"string"},"product_type":{"type":"string","enum":["prepaid","postpaid"]},"changes":{"type":"object","properties":{"price":{"type":"object","properties":{"old":{"type":"number"},"new":{"type":"number"}},"required":["old","new"]},"fee":{"type":"object","properties":{"old":{"type":"number"},"new":{"type":"number"}},"required":["old","new"]},"admin_fee":{"type":"object","properties":{"old":{"type":"number"},"new":{"type":"number"}},"required":["old","new"]},"commission":{"type":"object","properties":{"old":{"type":"number"},"new":{"type":"number"}},"required":["old","new"]}},"required":[],"minProperties":1}},"required":["code","product_name","product_type","changes"]},"minItems":1,"maxItems":100}},"required":["total","products"]}},"required":["event_id","event","environment","created_at","data"]}}}},"responses":{"401":{"description":"Signature tidak cocok atau timestamp di luar toleransi."},"2XX":{"description":"Event diterima. Balas dalam 10 detik. Body respons tidak diperlukan."},"default":{"description":"Pengiriman dianggap gagal."}}}},"balance.low":{"post":{"operationId":"receiveBalanceLow","tags":["Webhook"],"summary":"balance.low","description":"Dikirim ke URL HTTPS yang didaftarkan untuk environment terkait. Verifikasi HMAC-SHA256 atas timestamp, titik, dan byte body mentah, lalu deduplikasi dengan event_id. Selain 2xx atau timeout memicu percobaan ulang, maksimal delapan pengiriman dalam sekitar 24 jam.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/webhook#verifikasi"},"security":[],"parameters":[{"name":"X-Bisadagang-Event","in":"header","required":true,"schema":{"const":"balance.low"},"description":"Jenis event, sama dengan field event."},{"name":"X-Bisadagang-Delivery","in":"header","required":true,"schema":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"description":"ID stabil yang sama dengan event_id, termasuk saat dikirim ulang."},{"name":"X-Bisadagang-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]{1,12}$"},"description":"Timestamp Unix dalam detik. Verifikasi toleransi 300 detik."},{"name":"X-Bisadagang-Signature","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{64}(,[0-9a-f]{64})?$"},"description":"Hex huruf kecil hasil HMAC-SHA256. Saat rotasi, dua signature dipisah koma. Terima jika salah satunya cocok secara constant-time."},{"name":"User-Agent","in":"header","required":true,"schema":{"const":"Bisadagang-Webhook/1.0"},"description":"Identitas pengirim HTTP."},{"name":"Content-Length","in":"header","required":true,"schema":{"type":"integer"},"description":"Ukuran body dalam byte. Media type body adalah application/json."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"event":{"const":"balance.low"},"environment":{"const":"production"},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","properties":{"balance":{"type":"number"},"threshold":{"type":"number"},"currency":{"const":"IDR"}},"required":["balance","threshold","currency"]}},"required":["event_id","event","environment","created_at","data"]}}}},"responses":{"401":{"description":"Signature tidak cocok atau timestamp di luar toleransi."},"2XX":{"description":"Event diterima. Balas dalam 10 detik. Body respons tidak diperlukan."},"default":{"description":"Pengiriman dianggap gagal."}}}},"webhook.test":{"post":{"operationId":"receiveWebhookTest","tags":["Webhook"],"summary":"webhook.test","description":"Dikirim ke URL HTTPS yang didaftarkan untuk environment terkait. Verifikasi HMAC-SHA256 atas timestamp, titik, dan byte body mentah, lalu deduplikasi dengan event_id. Tes dari dashboard dikirim satu kali.","externalDocs":{"url":"https://bisnis.bisadagang.com/docs/api/webhook#verifikasi"},"security":[],"parameters":[{"name":"X-Bisadagang-Event","in":"header","required":true,"schema":{"const":"webhook.test"},"description":"Jenis event, sama dengan field event."},{"name":"X-Bisadagang-Delivery","in":"header","required":true,"schema":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"description":"ID stabil yang sama dengan event_id, termasuk saat dikirim ulang."},{"name":"X-Bisadagang-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]{1,12}$"},"description":"Timestamp Unix dalam detik. Verifikasi toleransi 300 detik."},{"name":"X-Bisadagang-Signature","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{64}(,[0-9a-f]{64})?$"},"description":"Hex huruf kecil hasil HMAC-SHA256. Saat rotasi, dua signature dipisah koma. Terima jika salah satunya cocok secara constant-time."},{"name":"User-Agent","in":"header","required":true,"schema":{"const":"Bisadagang-Webhook/1.0"},"description":"Identitas pengirim HTTP."},{"name":"Content-Length","in":"header","required":true,"schema":{"type":"integer"},"description":"Ukuran body dalam byte. Media type body adalah application/json."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string","pattern":"^whd_[0-9A-Za-z]{24}$"},"event":{"const":"webhook.test"},"environment":{"type":"string","enum":["production","sandbox"]},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["event_id","event","environment","created_at","data"]}}}},"responses":{"401":{"description":"Signature tidak cocok atau timestamp di luar toleransi."},"2XX":{"description":"Event diterima. Balas dalam 10 detik. Body respons tidak diperlukan."},"default":{"description":"Pengiriman dianggap gagal."}}}}},"components":{"securitySchemes":{"X-Bisadagang-Key":{"type":"apiKey","in":"header","name":"X-Bisadagang-Key","description":"API key berawalan bdk_live_ untuk production atau bdk_test_ untuk sandbox. Key menentukan environment."},"X-Bisadagang-Timestamp":{"type":"apiKey","in":"header","name":"X-Bisadagang-Timestamp","description":"Waktu Unix dalam detik (1–12 digit), paling banyak 300 detik dari jam server."},"X-Bisadagang-Nonce":{"type":"apiKey","in":"header","name":"X-Bisadagang-Nonce","description":"String acak 16–64 karakter A–Z, a–z, 0–9, garis bawah, atau tanda hubung. Buat nonce baru untuk setiap request. Nonce yang sudah dipakai ditolak selama 10 menit."},"X-Bisadagang-Signature":{"type":"apiKey","in":"header","name":"X-Bisadagang-Signature","description":"64 karakter hex hasil HMAC-SHA256 atas string canonical. Gunakan huruf kecil. Server menerima huruf besar juga."}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,100}$"},"description":"Wajib untuk transaksi prabayar dan pembayaran tagihan. Berlaku 24 jam per Mitra Bisnis dan environment. Hasil sukses disimpan berdasarkan key dan byte body. Ulangi dengan key dan body yang sama serta header signature baru. Setelah error, key dapat digunakan kembali."}},"headers":{"RateLimit":{"description":"Batas request per menit untuk kelompok endpoint.","schema":{"type":"integer"}},"RateLimitRemaining":{"description":"Sisa request dalam jendela satu menit.","schema":{"type":"integer"}},"RetryAfter":{"description":"Detik sampai jendela berikutnya.","schema":{"type":"integer","minimum":1,"maximum":60}}},"schemas":{"Balance":{"type":"object","properties":{"balance":{"type":"number"},"currency":{"const":"IDR"},"environment":{"type":"string","enum":["production","sandbox"]}},"required":["balance","currency","environment"]},"Products":{"type":"object","properties":{"updated_at":{"type":"string","format":"date-time"},"total":{"type":"integer"},"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}},"required":["updated_at","total","products"]},"Product":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Z0-9]{1,20}$"},"product_name":{"type":"string"},"category":{"type":"string"},"brand":{"type":"string"},"type":{"type":"string"},"product_type":{"type":"string","enum":["prepaid","postpaid"]},"is_open_amount":{"type":"boolean"},"status":{"type":"string","enum":["normal","gangguan"]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"fee":{"anyOf":[{"type":"number"},{"type":"null"}]},"admin_fee":{"anyOf":[{"type":"number"},{"type":"null"}]},"commission":{"anyOf":[{"type":"number"},{"type":"null"}]},"active":{"type":"boolean"},"success_rate":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"speed_seconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"success_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"failed_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"success_rate_30d":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"speed_seconds_30d":{"anyOf":[{"type":"number"},{"type":"null"}]},"success_count_30d":{"anyOf":[{"type":"integer"},{"type":"null"}]},"failed_count_30d":{"anyOf":[{"type":"integer"},{"type":"null"}]},"success_rate_90d":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"speed_seconds_90d":{"anyOf":[{"type":"number"},{"type":"null"}]},"success_count_90d":{"anyOf":[{"type":"integer"},{"type":"null"}]},"failed_count_90d":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["code","product_name","category","brand","type","product_type","is_open_amount","status","price","fee","admin_fee","commission","active","success_rate","speed_seconds","success_count","failed_count","success_rate_30d","speed_seconds_30d","success_count_30d","failed_count_30d","success_rate_90d","speed_seconds_90d","success_count_90d","failed_count_90d"]},"CreateTransaction":{"type":"object","properties":{"product_code":{"type":"string","pattern":"^\\s*[A-Za-z0-9]{1,20}\\s*$","description":"Kode produk. Backend melakukan trim dan mengubah huruf menjadi kapital."},"customer_no":{"type":"string","pattern":"^\\s*[0-9]{4,20}\\s*$","description":"Nomor tujuan sebagai string. Backend melakukan trim sebelum validasi."},"ref_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,50}$"},"max_price":{"type":"integer","minimum":1,"maximum":100000000,"description":"Opsional. Harga maksimum dalam rupiah; hilangkan field jika tidak digunakan. Jangan kirim null."},"amount":{"type":"integer","minimum":1,"maximum":100000000,"description":"Opsional untuk request; wajib untuk produk nominal bebas dengan batas sesuai produk. Untuk produk nominal tetap, hilangkan field. Jangan kirim null."},"account_check_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Wajib untuk produk nominal bebas. Gunakan check_id yang masih berlaku untuk produk dan tujuan yang sama."}},"required":["product_code","customer_no","ref_id"]},"Transaction":{"type":"object","properties":{"transaction_id":{"type":"string"},"ref_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,50}$"},"product_code":{"type":"string","pattern":"^[A-Z0-9]{1,20}$"},"customer_no":{"type":"string","pattern":"^[0-9]{4,20}$"},"price":{"type":"number"},"status":{"type":"string","enum":["pending","success","failed"]},"sn":{"anyOf":[{"type":"string"},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"product_type":{"type":"string","enum":["prepaid","postpaid"]},"created_at":{"type":"string","format":"date-time"},"inquiry_id":{"type":"string","format":"uuid","description":"Hanya pembayaran pascabayar."},"commission":{"type":"number","description":"Hanya pembayaran pascabayar. Komisi sudah dikurangkan dari price."},"amount":{"type":"number","description":"Hanya transaksi nominal bebas."},"account_name":{"type":"string","description":"Hanya transaksi nominal bebas."}},"required":["transaction_id","ref_id","product_code","customer_no","price","status","sn","message","product_type","created_at"]},"ProductDestination":{"type":"object","properties":{"product_code":{"type":"string","pattern":"^\\s*[A-Za-z0-9]{1,20}\\s*$","description":"Kode produk. Backend melakukan trim dan mengubah huruf menjadi kapital."},"customer_no":{"type":"string","pattern":"^\\s*[0-9]{4,20}\\s*$","description":"Nomor tujuan sebagai string. Backend melakukan trim sebelum validasi."}},"required":["product_code","customer_no"]},"BillInquiry":{"type":"object","properties":{"inquiry_id":{"type":"string","format":"uuid"},"product_code":{"type":"string","pattern":"^[A-Z0-9]{1,20}$"},"customer_no":{"type":"string","pattern":"^[0-9]{4,20}$"},"customer_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"bill_total":{"type":"number","description":"Total termasuk biaya admin."},"admin_fee":{"type":"number"},"commission":{"type":"number"},"price":{"type":"number","description":"Total tagihan dikurangi komisi."},"details":{"description":"Rincian dari penyedia. Struktur dan tipe dapat berbeda antar produk."},"expires_at":{"type":"string","format":"date-time"}},"required":["inquiry_id","product_code","customer_no","customer_name","bill_total","admin_fee","commission","price","details","expires_at"]},"PayBill":{"type":"object","properties":{"inquiry_id":{"type":"string","format":"uuid"},"ref_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,50}$"}},"required":["inquiry_id","ref_id"]},"AccountCheck":{"type":"object","properties":{"check_id":{"type":"string","format":"uuid"},"product_code":{"type":"string","pattern":"^[A-Z0-9]{1,20}$"},"customer_no":{"type":"string","pattern":"^[0-9]{4,20}$"},"account_name":{"type":"string"},"expires_at":{"type":"string","format":"date-time"}},"required":["check_id","product_code","customer_no","account_name","expires_at"]},"CreateComplaint":{"type":"object","properties":{"ref_id":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}]},"transaction_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]},"reason":{"type":"string","enum":["pending_too_long","success_not_received","invalid_sn","other"]},"note":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]}},"required":["reason"],"description":"Isi salah satu ID yang tidak kosong setelah trim. Untuk reason other, note wajib berisi setidaknya 10 karakter setelah trim.","anyOf":[{"required":["ref_id"],"properties":{"ref_id":{"type":"string","pattern":"\\S"}}},{"required":["transaction_id"],"properties":{"transaction_id":{"type":"string","pattern":"\\S"}}}],"not":{"required":["ref_id","transaction_id"],"properties":{"ref_id":{"type":"string","pattern":"\\S"},"transaction_id":{"type":"string","pattern":"\\S"}}},"if":{"properties":{"reason":{"const":"other"}},"required":["reason"]},"then":{"required":["note"],"properties":{"note":{"type":"string","minLength":10}}}},"Complaint":{"type":"object","properties":{"complaint_id":{"type":"string"},"transaction_id":{"type":"string"},"ref_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,50}$"},"status":{"type":"string","enum":["open","processing","resolved"]},"result":{"anyOf":[{"type":"string","enum":["success","failed"]},{"type":"null"}]},"product_code":{"type":"string","pattern":"^[A-Z0-9]{1,20}$"},"product_name":{"type":"string"},"customer_no":{"type":"string","pattern":"^[0-9]{4,20}$"},"price":{"type":"number"},"reason":{"type":"string","enum":["pending_too_long","success_not_received","invalid_sn","other"]},"source":{"type":"string","enum":["api","dashboard"]},"environment":{"type":"string","enum":["production","sandbox"]},"created_at":{"type":"string","format":"date-time"},"messages":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string","enum":["partner","team","system"]},"text":{"type":"string"},"created_at":{"type":"string","format":"date-time"}},"required":["from","text","created_at"]}}},"required":["complaint_id","transaction_id","ref_id","status","result","product_code","product_name","customer_no","price","reason","source","environment","created_at","messages"]},"Complaints":{"type":"object","properties":{"complaints":{"type":"array","items":{"$ref":"#/components/schemas/Complaint"}},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["complaints","next_cursor"]},"ReplyComplaint":{"type":"object","properties":{"text":{"type":"string","pattern":"\\S","maxLength":1000}},"required":["text"]},"ValidationIssue":{"type":"object","properties":{"field":{"type":"string"},"constraint":{"type":"string"},"message":{"type":"string"}},"required":["field","constraint","message"]},"VALIDATION_ERROR":{"type":"object","properties":{"code":{"const":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"anyOf":[{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/ValidationIssue"}},{"type":"array","items":{"type":"string"}}]}},"required":["code","message","details"]},"INVALID_API_KEY":{"type":"object","properties":{"code":{"const":"INVALID_API_KEY"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"TIMESTAMP_OUT_OF_RANGE":{"type":"object","properties":{"code":{"const":"TIMESTAMP_OUT_OF_RANGE"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"INVALID_SIGNATURE":{"type":"object","properties":{"code":{"const":"INVALID_SIGNATURE"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"NONCE_REUSED":{"type":"object","properties":{"code":{"const":"NONCE_REUSED"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"HTTPS_REQUIRED":{"type":"object","properties":{"code":{"const":"HTTPS_REQUIRED"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"IP_NOT_WHITELISTED":{"type":"object","properties":{"code":{"const":"IP_NOT_WHITELISTED"},"message":{"type":"string"},"details":{"type":"object","properties":{"ip":{"type":"string"}},"required":["ip"]}},"required":["code","message","details"]},"PARTNER_NOT_ACTIVE":{"type":"object","properties":{"code":{"const":"PARTNER_NOT_ACTIVE"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"PARTNER_SUSPENDED":{"type":"object","properties":{"code":{"const":"PARTNER_SUSPENDED"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"NOT_FOUND":{"type":"object","properties":{"code":{"const":"NOT_FOUND"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"PRODUCT_NOT_FOUND":{"type":"object","properties":{"code":{"const":"PRODUCT_NOT_FOUND"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"REF_ID_CONFLICT":{"type":"object","properties":{"code":{"const":"REF_ID_CONFLICT"},"message":{"type":"string"},"details":{"type":"object","properties":{"transaction_id":{"type":"string"}},"required":["transaction_id"]}},"required":["code","message","details"]},"REQUEST_IN_PROGRESS":{"type":"object","properties":{"code":{"const":"REQUEST_IN_PROGRESS"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"COMPLAINT_EXISTS":{"type":"object","properties":{"code":{"const":"COMPLAINT_EXISTS"},"message":{"type":"string"},"details":{"type":"object","properties":{"complaint_id":{"type":"string"}},"required":["complaint_id"]}},"required":["code","message","details"]},"UNSUPPORTED_CONTENT_TYPE":{"type":"object","properties":{"code":{"const":"UNSUPPORTED_CONTENT_TYPE"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"PRODUCT_DISABLED":{"type":"object","properties":{"code":{"const":"PRODUCT_DISABLED"},"message":{"type":"string"},"details":{"anyOf":[{"type":"object","properties":{"reason":{"const":"auto_disabled"},"success_rate":{"anyOf":[{"type":"number"},{"type":"null"}]},"threshold":{"type":"number"},"disabled_at":{"type":"string","format":"date-time"}},"required":["reason","success_rate","threshold","disabled_at"]},{"type":"null"}]}},"required":["code","message","details"]},"PRODUCT_DISRUPTED":{"type":"object","properties":{"code":{"const":"PRODUCT_DISRUPTED"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"PRODUCT_NOT_SUPPORTED":{"type":"object","properties":{"code":{"const":"PRODUCT_NOT_SUPPORTED"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"PRICE_CHANGED":{"type":"object","properties":{"code":{"const":"PRICE_CHANGED"},"message":{"type":"string"},"details":{"type":"object","properties":{"price":{"type":"number"},"max_price":{"type":"number"}},"required":["price","max_price"]}},"required":["code","message","details"]},"INSUFFICIENT_BALANCE":{"type":"object","properties":{"code":{"const":"INSUFFICIENT_BALANCE"},"message":{"type":"string"},"details":{"type":"object","properties":{"price":{"type":"number"}},"required":["price"]}},"required":["code","message","details"]},"IDEMPOTENCY_KEY_REUSED":{"type":"object","properties":{"code":{"const":"IDEMPOTENCY_KEY_REUSED"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"DESTINATION_BLOCKED":{"type":"object","properties":{"code":{"const":"DESTINATION_BLOCKED"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"DESTINATION_LIMIT_REACHED":{"type":"object","properties":{"code":{"const":"DESTINATION_LIMIT_REACHED"},"message":{"type":"string"},"details":{"type":"object","properties":{"reason":{"type":"string"}},"required":["reason"]}},"required":["code","message","details"]},"ACCOUNT_CHECK_REQUIRED":{"type":"object","properties":{"code":{"const":"ACCOUNT_CHECK_REQUIRED"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"ACCOUNT_NOT_FOUND":{"type":"object","properties":{"code":{"const":"ACCOUNT_NOT_FOUND"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"INQUIRY_FAILED":{"type":"object","properties":{"code":{"const":"INQUIRY_FAILED"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"INQUIRY_EXPIRED":{"type":"object","properties":{"code":{"const":"INQUIRY_EXPIRED"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"INQUIRY_ALREADY_PAID":{"type":"object","properties":{"code":{"const":"INQUIRY_ALREADY_PAID"},"message":{"type":"string"},"details":{"type":"object","properties":{"ref_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,50}$"}},"required":["ref_id"]}},"required":["code","message","details"]},"COMPLAINT_NOT_ALLOWED":{"type":"object","properties":{"code":{"const":"COMPLAINT_NOT_ALLOWED"},"message":{"type":"string"},"details":{"type":"object","properties":{"status":{"type":"string","enum":["pending","success","failed"]},"allowed_reasons":{"type":"array","items":{"type":"string","enum":["pending_too_long","success_not_received","invalid_sn","other"]}}},"required":["status","allowed_reasons"]}},"required":["code","message","details"]},"COMPLAINT_WINDOW_CLOSED":{"type":"object","properties":{"code":{"const":"COMPLAINT_WINDOW_CLOSED"},"message":{"type":"string"},"details":{"type":"object","properties":{"deadline":{"type":"string","format":"date-time"}},"required":["deadline"]}},"required":["code","message","details"]},"COMPLAINT_CLOSED":{"type":"object","properties":{"code":{"const":"COMPLAINT_CLOSED"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"RATE_LIMITED":{"type":"object","properties":{"code":{"const":"RATE_LIMITED"},"message":{"type":"string"},"details":{"type":"object","properties":{"limit":{"type":"integer"},"group":{"type":"string"},"retry_after_seconds":{"type":"integer"}},"required":["limit","group","retry_after_seconds"]}},"required":["code","message","details"]},"INTERNAL_ERROR":{"type":"object","properties":{"code":{"const":"INTERNAL_ERROR"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"SERVICE_MAINTENANCE":{"type":"object","properties":{"code":{"const":"SERVICE_MAINTENANCE"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"SUPPLIER_UNAVAILABLE":{"type":"object","properties":{"code":{"const":"SUPPLIER_UNAVAILABLE"},"message":{"type":"string"},"details":{"type":"null"}},"required":["code","message","details"]},"AMOUNT_VALIDATION_ERROR":{"type":"object","properties":{"code":{"const":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"object","properties":{"min":{"type":"number"},"max":{"type":"number"}},"required":["min","max"]}},"required":["code","message","details"]}},"responses":{"Error400":{"description":"VALIDATION_ERROR — Parameter, header, atau body tidak valid.","x-error-codes":["VALIDATION_ERROR"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/VALIDATION_ERROR"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"Error401":{"description":"INVALID_API_KEY — API key kosong, tidak valid, kedaluwarsa, atau dicabut.\n\nTIMESTAMP_OUT_OF_RANGE — Timestamp tidak valid atau berbeda lebih dari 300 detik.\n\nINVALID_SIGNATURE — Signature atau format nonce tidak valid.\n\nNONCE_REUSED — Nonce sudah digunakan dengan API key ini.","x-error-codes":["INVALID_API_KEY","TIMESTAMP_OUT_OF_RANGE","INVALID_SIGNATURE","NONCE_REUSED"],"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/INVALID_API_KEY"},{"$ref":"#/components/schemas/TIMESTAMP_OUT_OF_RANGE"},{"$ref":"#/components/schemas/INVALID_SIGNATURE"},{"$ref":"#/components/schemas/NONCE_REUSED"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"Error403":{"description":"HTTPS_REQUIRED — Gunakan HTTPS.\n\nIP_NOT_WHITELISTED — IP pemanggil tidak terdaftar.\n\nPARTNER_NOT_ACTIVE — Akun Mitra Bisnis belum aktif.\n\nPARTNER_SUSPENDED — Akun Mitra Bisnis dibekukan.","x-error-codes":["HTTPS_REQUIRED","IP_NOT_WHITELISTED","PARTNER_NOT_ACTIVE","PARTNER_SUSPENDED"],"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/HTTPS_REQUIRED"},{"$ref":"#/components/schemas/IP_NOT_WHITELISTED"},{"$ref":"#/components/schemas/PARTNER_NOT_ACTIVE"},{"$ref":"#/components/schemas/PARTNER_SUSPENDED"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"Error415":{"description":"UNSUPPORTED_CONTENT_TYPE — Request dengan body harus memakai application/json.","x-error-codes":["UNSUPPORTED_CONTENT_TYPE"],"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/UNSUPPORTED_CONTENT_TYPE"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"Error429":{"description":"RATE_LIMITED — Batas request per menit tercapai. Ikuti Retry-After.","x-error-codes":["RATE_LIMITED"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/RATE_LIMITED"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"Error500":{"description":"INTERNAL_ERROR — Terjadi kesalahan pada server Bisadagang.","x-error-codes":["INTERNAL_ERROR"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/INTERNAL_ERROR"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}},"Error503":{"description":"SERVICE_MAINTENANCE — Layanan sedang dalam pemeliharaan atau gangguan.","x-error-codes":["SERVICE_MAINTENANCE"],"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":false},"error":{"oneOf":[{"$ref":"#/components/schemas/SERVICE_MAINTENANCE"}]},"request_id":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{10}$"},{"type":"null"}]}},"required":["success","error","request_id"]}}}}}}}