Payment Match

Mengubah status invoice dari PENDING menjadi PAID secara manual.

Gunakan fitur ini sebagai langkah antisipasi apabila pelanggan telah melakukan transfer, namun sistem Android Worker gagal mendeteksinya secara otomatis.

Catatan Keamanan: Fitur ini mewajibkan penggunaan 2FA (TOTP). Pastikan Anda telah mengaktifkannya melalui Dashboard → Akun Saya → 2FA. Pindai kode QR menggunakan aplikasi seperti Google Authenticator, lalu gunakan 6 digit kode yang dihasilkan pada saat melakukan request.

Request

Endpoint

Method	URL
POST	https://api.bayar.digital/gateway/payments/{payment_code}/match

Parameter

Parameter	Tipe	Wajib	Deskripsi
payment_code	string	Ya	Kode invoice dari sistem Anda yang akan dicocokkan

Header

Header	Wajib	Deskripsi
X-Api-Key	Ya	API Key merchant Anda
X-Totp-Code	Ya	Kode 6 digit OTP dari aplikasi Authenticator

Body

Field	Tipe	Wajib	Deskripsi
mutation_id	uuid	Tidak	ID mutasi bank yang ingin dikaitkan (opsional jika ada)

Contoh

curl -X POST https://api.bayar.digital/gateway/payments/INV-2026-0001/match \
  -H "X-Api-Key: pk_..." \
  -H "X-Totp-Code: 123456" \
  -H "Content-Type: application/json" \
  -d '{
    "mutation_id": "550e8400-e29b-41d4-a716-446655440020"
  }'

Response

Sukses

Field	Tipe	Deskripsi
success	bool	true
message	string	"ok"
data	null	Selalu null

200 OK

{
  "success": true,
  "message": "ok",
  "data": null
}

Gagal

Code	Status	Keterangan
X-Totp-Code header is required	400	Header X-Totp-Code tidak disertakan pada request
invalid totp code	400	Kode TOTP yang dimasukkan salah atau sudah kedaluwarsa
tenant_api_key_required	403	API Key tidak valid atau tidak disertakan
totp_not_enabled	403	Fitur 2FA (TOTP) belum diaktifkan pada akun Anda
not_found	404	Invoice tidak ditemukan atau statusnya bukan PENDING
internal_error	500	Terjadi kendala pada server, silakan coba beberapa saat lagi

400 Bad Request

{
  "success": false,
  "code": "invalid totp code",
  "message": "invalid totp code"
}

403 Forbidden

{
  "success": false,
  "code": "totp_not_enabled",
  "message": "totp not enabled"
}