Create Payment Emoney
API Name Create Emoney Function Layanan untuk menerima dana dari Aplikasi E-wallet. Layanan ini akan memberi notifikasi pembayaran langsung ke aplikasi pelanggan. FAQ: Nominal minimum adalah IDR 15.000,00 Nominal maksimal adalah IDR 2.500.000,00 Settlement membutuhkan 2-4 hari untuk menerima dana ke saldo Anda. Service Code 29 Method POST URL /snap/v1.0/payment/emoney Content Type application/json Related Service E-money
Request
Header
No Name Type Length Required Condition Remarks 1 Authorization String Variable Wajib – Berisikan B2B Bearer JWT Token, yang didapatkan dari Access Token B2B 2 Content-Type String Variable, 127 max Wajib – Tipe konten, nilai selalu application/json 3 X-TIMESTAMP String Fixed, 25 max Wajib – Waktu transaksi, dalam format YYYY-MM-DDTHH:mm:ss+07:00. Zona waktu harus GMT+7 (Jakarta time) 4 X-PARTNER-ID String Variable, 36 max Wajib – ID untuk mitra yang dihasilkan oleh PakaiLink. Unique ID untuk mitra 5 X-EXTERNAL-ID String Variable, 36 max Wajib – Messaging reference ID unik yang dihasilkan oleh merchant. Numeric String. Nomor referensi harus unik di hari yang sama. 6 X-SIGNATURE String Variable Wajib – Signature harus dihasilkan dengan metode Symmetric Signature 7 CHANNEL-ID String Variable, 5 max Wajib – Identifikasi perangkat dimana API Service ini sedang diakses oleh pengguna. Daftar Channel ID dapat dilihat di sini .
Body
No nama Tipe Panjang Wajib Condition Keterangan 1 parnerReferenceNo String Variable, maksimal Wajib – Nomor unik (hingga 20 digits). 2 customerId String Variable, maksimal 35 Wajib – Pengidentifikasi unik untuk pelanggan di dalam sistem 3 customerName String Variable, maksimal 100 Wajib – Pengidentifikasiunik untuk pelanggan yang disediakan oleh mitra. 4 customerPhone String Variable, maksimal 15 Optional – Nomor telepon pelanggan yang disediakan oleh mitra 5 customerEmail String Variable, maksimal 225 Optional – Alamat email pelanggan yang disediakan oleh mitra 6 expiredDate Sreing Variable Optional y Waktu kedaluwarsa dari VA dinamis yang dibuat (dalam format ISO). Jika variable ini tidak diisi, maka secara default akan diisi 24 jam oleh sistem. 7 totalAmount money Variable Wajib – Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO 8 additionalInfo String Variable Wajib – Informasi tambahan 9 additionalInfo.productCode String Variable, maksimal 20 Wajib – Kode yang mewakili jenis metode pembayaran digital 10 additionalInfo.emoneyPhone String text Wajib – Nomor telepon e-money yang ditautkan 11 additionalInfo.billTitle String variabel Optional – Judul penagihan yang jelas dan ringkas untuk memudahkan identifikasi pembayaran. 12 additionalInfo.callbackUrl String text Wajib – URL untuk dapat menerima notifikasi pembayaran setelah pembayaran dilakukan oleh pelanggan
Contoh Request
POST /snap/v1.0/payment/emoney
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: 1068976176
X-SIGNATURE: AaE7rxaiIFPQYryj+JxwOi826dQG4e8RbzagEBaAywS4ETa490Cy/3b1/Ljqput67EF+OgE0V1GDw2t/lxqEJw==
CHANNEL-ID: 95221
{
"partnerReferenceNo": "V9I4JJJott8YQu4jZgWLUmHM7unEQ5B4j0Hh",
"customerId": "31857118",
"customerName": "Hermawan",
"customerPhone": "081133383900",
"customerEmail": "test@gmail.com",
"expiredDate": "2025-04-23T11:01:34+07:00",
"totalAmount": {
"value": "11000.00",
"currency": "IDR"
},
"additionalInfo": {
"productCode": "PAYOVO",
"emoneyPhone": "081133383900",
"billTitle": "Payment Order 0000001",
"callbackUrl": "http://localhost:10007/callback/partner"
}
}
Response
Body
No Name Type Length Required Condition Remarks 1 responseCode String Fixed, 7 max Wajib – Lihat daftar kode response. 2 responseMessage String Variable, 150 max Wajib – Lihat daftar kode response. 3 emoneyData String Variable Wajib – Berisikan data e-money. 4 paymentCode 5 referenceNo String Variable Wajib – Identifikasi transaksi yang sedang berlangsung 6 feeAmount JSON Object Variable Wajib – Jumlah biaya yang dikenakan dalam suatu transaksi 7 feeAmount.value String Variable Wajib – Nominal feeAmount, termasuk pecahan. 8 feeAmount.currency String Variable Wajib – Kode mata uang berdasarkan ISO
Contoh Response
{
"responseCode": "2002900",
"responseMessage": "Successful",
"emoneyData": {
"partnerReferenceNo": "V9I4JJJott8YQu4jZgWLUmHM7unEQ5B4j0Hh",
"customerId": "31857118",
"customerName": "Hermawan",
"customerPhone": "081133383900",
"customerEmail": "test@gmail.com",
"paymentCode": "1741068977957",
"referenceNo": "EMI000002S",
"totalAmount": {
"value": "11000.00",
"currency": "IDR"
},
"feeAmount": {
"value": "3000.00",
"currency": "IDR"
},
"additionalInfo": {
"productCode": "PAYOVO",
"emoneyPhone": "081133383900",
"billTitle": "Payment Order 0000001",
"callbackUrl": "http://localhost:10007/callback/partner"
}
}
}
Kode dan Pesan Response
No Kode Response Pesan Response Keterangan 1 2002900 Successful Request telah berhasil diproses tanpa ada masalah 2 4002901 Invalid Field Format Panjang informasi tidak boleh melebihi 150 karakter 3 4002902 Invalid Wajib Field Kolom atau field yang wajib diisi tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan 4 4012900 Unauthorized. [reason] Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk mengakses tindakan tertentu 5 4012901 Invalid Token (B2B) Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa 6 4032901 Feature Not Allowed Fitur yang diminta tidak diizinkan atau tidak tersedia 7 4032902 Exceeds Transaction Amount Limit Jumlah uang terkecil atau terbesar yang dapat diproses dalam transaksi 8 4042903 Bank Not Supported By Switch Bank yang digunakan tidak didukung oleh sistem 9 4092900 Conflict X-EXTERNAL-ID tidak dapat digunakan lebih dari sekali dalam satu hari yang sama 10 4092901 Duplicate partnerReferenceNo Nomor referensi mitra (partnerReferenceNo, trxId) yang digunakan sudah terdaftar atau digunakan sebelumnya dalam sistem 11 5002902 Backend system failure Kesalahan yang terjadi di server saat mencoba memproses permintaan