Dokumentasi API

Inquiry Status – Customer Topup

API NameInquiry Status – Customer Topup
FunctionAPI yang digunakan untuk melakukan pengecekan status terakhir dari transaksi transfer bank yang dilakukan.
Service Code40
MethodPOST
URL/snap/v1.0/emoney/topup/status
Content Typeapplication/json
Related ServiceCustomer Topup

Request​

Header​

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

Body

NoNameTypeLengthRequiredConditionRemarks
1originalPartnerReferenceNoStringVariable, 64 maxWajibIdentitas transaksi asli pada sistem konsumen layanan.
2originalReferenceNoStringVariable, 32 maxWajibIdentitas transaksi asli dari sistem PakaiLink.
3serviceCodeStringVariable, 10 maxOpsionalIndikator jenis transaksi customer topup (38).

Contoh Request​

POST snap/v1.0/emoney/topup/status
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: 1160854306
X-SIGNATURE: AaE7rxaiIFPQYryj+JxwOi826dQG4e8RbzagEBaAywS4ETa490Cy/3b1/Ljqput67EF+OgE0V1GDw2t/lxqEJw==
CHANNEL-ID: 95221
{
    "originalPartnerReferenceNo": "Glv9yFZIb5iwcc2PUviXG9M5r4UnjdffaCjI",
    "originalReferenceNo" : "EMO000002S",
    "serviceCode" : "38"
}

Response​

Body

NoNameTypeLengthRequiredConditionRemarks
1responseCodeStringVariable, 7 maxWajibMerujuk pada daftar kode respons.
2responseMessageStringVariable, 150 maxWajibMerujuk pada daftar kode respons.
3originalPartnerReferenceNoStringTetap, 7 maxWajibIdentitas transaksi asli pada sistem mitra.
4originalReferenceNoStringTetap, 7 maxWajibIdentitas transaksi asli pada sistem PakaiLink.
5originalExternalIdStringVariable, 32 maxWajibID Eksternal-Asli pada pesan header.
6serviceCodeStringVariable, 2 maxWajibIndikator jenis transaksi (kode layanan dari permintaan transaksi asli).
7transactionDateStringVariable, 25 maxWajibTanggal transaksi, dengan format YYYY-MM-DDTHH:mm:ss+07:00. Waktu harus dalam GMT+7 (waktu Jakarta).
8amountMoneyVariableWajibBerisi nominal yang berhasil dibayarkan, berisi dua sub-bidang: Nilai: Transaction paidAmount, termasuk pecahan Mata Uang: Kode mata uang berdasarkan ISO
9customerNumberStringVariable, 32 maxWajibNomor tujuan customer yang terdaftar di emoney.
10customerNameStringVariable, 50 maxWajibNama customer.
11productTypeStringVariable, 8 maxWajibJenis produk emoney dari transaksi yang dilakukan.
12latestTransactionStatusStringVariable, 2 maxWajibDeskripsi status transaksi dalam bahasa Indonesia: 00: Sukses 03: Tertunda 06: Gagal
13transactionStatusDescStringVariable, 32 maxWajibDeskripsi status transaksi dalam bahasa Indonesia: 00: Sukses 03: Tertunda 06: Gagal

Contoh Response

{
    "responseCode": "2004000",
    "responseMessage": "Successful",
    "originalPartnerReferenceNo": "Glv9yFZIb5iwcc2PUviXG9M5r4UnjdffaCjI",
    "originalReferenceNo": "EMO000002S",
    "originalExternalId": "5393477729",
    "serviceCode": "38",
    "transactionDate": "2025-04-23T14:31:18+07:00",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "customerNumber": "08113338390",
    "customerName": "Henda Sujiadi",
    "productType": "TOPUP OVO E-MONEY",
    "latestTransactionStatus": "00",
    "latestTransactionStatusDesc": {
        "english": "Success",
        "indonesia": "Sukses"
    }
}

Kode dan Pesan Response

NoResponse KodeResponse PesanKeterangan
12004000SuccessfulRequest telah berhasil diproses tanpa ada masalah
24004001Invalid Field FormatPanjang informasi tidak boleh melebihi 150 karakter
34004002Invalid Wajib FieldKolom atau field yang wajib diisi tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan
44014000Unauthorized. [reason]Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk mengakses tindakan tertentu
54014001Invalid Token (B2B)Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa
64034001Transaction Not FoundTransaksi tidak ditemukan
75004002Backend system failureKesalahan yang terjadi di server saat mencoba memproses request