Dokumentasi API

Inquiry Transaction Status

API NameInquiry Transaction Status
FunctionAPI ini digunakan untuk cek status terakhir dari transaksi Virtual Account
Service Code33
MethodPOST
URL/snap/v1.0/transfer-va/create-va-status
Content Typeapplication/json
Related ServiceE-Money

Request

Header

NoNameTypeLengthRequiredConditionRemarks
1Content-TypeStringVariable, 127 maxWajibโ€“Tipe konten, nilai selalu application/json
2AuthorizationStringVariableWajibโ€“Berisikan B2B Bearer JWT Token, yang didapatkan dari Access Token B2B
3X-TIMESTAMPStringFixed, 25 maxWajibโ€“Waktu transaksi, dalam format YYYY-MM-DDTHH:mm:ss+07:00. Zona waktu harus GMT+7 (Jakarta time)
4X-PARTNER-IDStringVariable, 36 maxWajibโ€“ID untuk mitra yang dihasilkan oleh PakaiLink. Unique ID untuk mitra
5X-EXTERNAL-IDStringVariable, 36 maxWajibโ€“Messaging reference ID unik yang dihasilkan oleh merchant. Numeric String. Nomor referensi harus unik di hari yang sama.
6CHANNEL-IDStringVariable, 5 maxWajibโ€“Identifikasi perangkat dimana API Service ini sedang diakses oleh pengguna. Daftar Channel ID dapat dilihat di sini.
7X-SIGNATUREStringVariableWajibโ€“Signature harus dihasilkan dengan metode Symmetric Signature

Body

NoNameTypeLengthRequiredConditionRemarks
1originalPartnerReferenceNoStringVariable, 64 maxOptionaly: (originalReferenceNo = null)Pengidentifikasi transaksi asli pada sistem mitra
2serviceCodeStringVariable, 2 maxWajibโ€“Indikator jenis transaksi (kode layanan dari transaksi asli)

Contoh Request

POST /snap/v1.0/transfer-va/create-va
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJQQUtBSUxJTksiLCJqdGkiOiIyNDc0NzdlNjk0ZGM3N2FhZDU5YzA4MjA1NzdmZmViNyIsImV4cCI6MTE3NDAyOTc2NzgsImFzIjoicGFydG5lciIsImlkIjoiUFRSMDAwMDAwMyJ9.XmUxHExWILJCHJG74Af8TPJljX2aOmUz4UwJXumxkqxW9uDsIrSX_M_j0uRzPOmaBkk2_rQiHIo_OX_qxv45Mg
Content-Type: application/json
X-TIMESTAMP: 2025-01-30T12:38:12+07:00
X-PARTNER-ID: PTR0000003
X-EXTERNAL-ID: 1059833850
X-SIGNATURE: 2aRrh2Gm2kMBZjX2wsRTB7ckGZf1pXjBfuJBY1hcBFx4m04eTWTjrxdV3mkcn6+ulN1DIr7SZucHbWnaTssGTQ==
CHANNEL-ID: 95221
{
    "originalPartnerReferenceNo": "NfANLqEBgleqptVWAWj7O7lNsjFZELtYhexA",
    "serviceCode": "33"
}

Response

Body

NoNameTypeLengthRequiredConditionRemarks
1responseCodeStringFixed, 7 maxWajibโ€“Lihat daftar kode response.
2responseMessageStringVariable, 150 maxWajibโ€“Lihat daftar kode response.
3originalPartnerReferenceNoStringVariable, 64 maxOptionalโ€“Pengidentifikasi transaksi asli pada sistem mitra
4originalReferenceNoStringVariable, 64 maxWajibjika berhasil, value akan terisiPengidentifikasi transaksi asli pada sistem PakaiLink
5originalExternalIdStringVariable, 32 maxOptionalโ€“ID eksternal asli pada pesan header
6serviceCodeStringVariable, 2 maxWajibโ€“Indikator jenis transaksi (kode layanan dari request transaksi asli)
7transactionDateStringFixed, 25 maxOptionalโ€“Waktu transaksi: ISO8601, dalam format YYYY-MM-DDTHH:mm:ss+07:00. Zona waktu harus GMT+7 (waktu Jakarta)
8latestTransactionStatusStringFixed, 2 maxWajibโ€“Kode kategori untuk status transaksi. Nilai-nilai tersebut meliputi: Berhasil, pesanan telah dibayar Dimulai, pesanan telah dibuat, tetapi belum dibayar Membayar, pesanan dalam proses pembayaran Dibatalkan, pesanan telah ditutup
9transactionStatusDescStringVariable, 50 maxOptionalโ€“Deskripsi status transaksi
10amountMoneyVariableWajibโ€“Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
11additionalInfoJSON ObjectVariableOptionalโ€“Informasi tambahan
12callback StringVariableWajib โ€“URL untuk dapat menerima notifikasi pembayaran setelah pembayaran dilakukan oleh pelanggan.
13customerData String Variable, 50 maxWajibโ€“ Nama pelanggan.
14rrn StringVariable, 12 max Wajibโ€“ Nomor referensi dari transaksi QRIS
15mdrMoneyVariableOptionalโ€“ Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
16serviceFeeMoneyVariableOptionalโ€“Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
17nominalPaidMoneyVariableOptionalโ€“ Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
18totalPaidMoneyVariableOptionalโ€“ Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
19totalReceiveMoneyVariableOptionalโ€“Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO

Contoh Response

{
    "additionalInfo": {
        "callback": "http://66.96.235.225:9600/callback",
        "nominalPaid": {
            "currency": "IDR",
            "value": "10000.00"
        },
        "serviceFee": {
            "currency": "IDR",
            "value": "4100.00"
        },
        "totalPaid": {
            "currency": "IDR",
            "value": "10000.00"
        },
        "totalReceive": {
            "currency": "IDR",
            "value": "5900.00"
        }
    },
    "amount": {
        "currency": "IDR",
        "value": "10000.00"
    },
    "latestTransactionStatus": "00",
    "originalExternalId": "25496c9e-abf6-4f11-8458-083d053653bc",
    "originalPartnerReferenceNo": "42354593-a08c-4223-9c87-1e1f63fcafcb",
    "originalReferenceNo": "53124603",
    "paidTime": "2025-03-03T21:34:12+07:00",
    "responseCode": "2003300",
    "responseMessage": "Successful",
    "serviceCode": "35",
    "transactionDate": "2025-07-12T23:43:11Z",
    "transactionStatusDesc": "Success"
}

Kode dan Pesan Response

NoResponse CodeResponse MessageRemarks
12003300SuccessfulRequest telah berhasil diproses tanpa ada masalah.
24003301Invalid Field FormatPanjang informasi tidak boleh melebihi 150 karakter.
34003302Invalid Mandatory FieldKolom atau field yang wajib diisi tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan.
44013300Unauthorized. [reason]Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk mengakses tindakan tertentu.
54013301Invalid Token (B2B)Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa.
64043301Transaction Not FoundTransaksi tidak ditemukan
74093300ConflictX-EXTERNAL-ID tidak dapat digunakan lebih dari sekali dalam satu hari yang sama
84093301Duplicate partnerReferenceNoNomor referensi mitra (partnerReferenceNo, trxId) yang digunakan sudah terdaftar atau digunakan sebelumnya dalam sistem
95003302Backend system failureKesalahan yang terjadi di server saat mencoba memproses request