Dokumentasi API

Create Payment Emoney

API NameCreate Emoney
FunctionLayanan 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 Code29
MethodPOST
URL/snap/v1.0/payment/emoney
Content Typeapplication/json
Related ServiceE-money 

Request​

Header

NoNameTypeLengthRequiredConditionRemarks
1AuthorizationStringVariableWajibBerisikan B2B Bearer JWT Token, yang didapatkan dari Access Token B2B
2Content-TypeStringVariable, 127 maxWajibTipe konten, nilai selalu application/json
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.
6X-SIGNATUREStringVariableWajibSignature harus dihasilkan dengan metode Symmetric Signature
7CHANNEL-IDStringVariable, 5 maxWajibIdentifikasi perangkat dimana API Service ini sedang diakses oleh pengguna. Daftar Channel ID dapat dilihat di sini.

Body

NonamaTipePanjangWajibConditionKeterangan
1parnerReferenceNoStringVariable, maksimal WajibNomor unik (hingga 20 digits). 
2customerIdStringVariable, maksimal 35WajibPengidentifikasi unik untuk pelanggan di dalam sistem
3customerNameStringVariable, maksimal 100WajibPengidentifikasiunik untuk pelanggan yang disediakan oleh mitra.
4customerPhoneStringVariable, maksimal 15OptionalNomor telepon pelanggan yang disediakan oleh mitra
5customerEmailStringVariable, maksimal 225OptionalAlamat email pelanggan yang disediakan oleh mitra
6expiredDateSreingVariableOptionalyWaktu kedaluwarsa dari VA dinamis yang dibuat (dalam format ISO). Jika variable ini tidak diisi, maka secara default akan diisi 24 jam oleh sistem.
7totalAmountmoneyVariableWajibBerisi dua sub-field.
Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
8additionalInfoStringVariableWajibInformasi tambahan
9additionalInfo.productCodeStringVariable, maksimal 20WajibKode yang mewakili jenis metode pembayaran digital
10additionalInfo.emoneyPhoneStringtextWajibNomor telepon e-money yang ditautkan
11additionalInfo.billTitleStringvariabelOptionalJudul penagihan yang jelas dan ringkas untuk memudahkan identifikasi pembayaran.
12additionalInfo.callbackUrlStringtextWajibURL 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

NoNameTypeLengthRequiredConditionRemarks
1responseCodeStringFixed, 7 maxWajibLihat daftar kode response.
2responseMessageStringVariable, 150 maxWajibLihat daftar kode response.
3emoneyDataStringVariableWajibBerisikan data e-money.
4paymentCode     
5referenceNoStringVariableWajibIdentifikasi transaksi yang sedang berlangsung
6feeAmountJSON ObjectVariableWajibJumlah biaya yang dikenakan dalam suatu transaksi
7feeAmount.valueStringVariableWajib Nominal feeAmount, termasuk pecahan.
8feeAmount.currencyStringVariableWajibKode 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

NoKode ResponsePesan ResponseKeterangan
12002900SuccessfulRequest telah berhasil diproses tanpa ada masalah
24002901Invalid Field FormatPanjang informasi tidak boleh melebihi 150 karakter
34002902Invalid Wajib FieldKolom atau field yang wajib diisi tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan
44012900Unauthorized. [reason]Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk mengakses tindakan tertentu
54012901Invalid Token (B2B)Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa
64032901Feature Not AllowedFitur yang diminta tidak diizinkan atau tidak tersedia
74032902Exceeds Transaction Amount LimitJumlah uang terkecil atau terbesar yang dapat diproses dalam transaksi
84042903Bank Not Supported By SwitchBank yang digunakan tidak didukung oleh sistem
94092900ConflictX-EXTERNAL-ID tidak dapat digunakan lebih dari sekali dalam satu hari yang sama
104092901Duplicate partnerReferenceNoNomor referensi mitra (partnerReferenceNo, trxId) yang digunakan sudah terdaftar atau digunakan sebelumnya dalam sistem
115002902Backend system failureKesalahan yang terjadi di server saat mencoba memproses permintaan