E-Money

E-Money Order API

Panduan lengkap untuk membuat E-Money Order menggunakan API Paylabs.

Request Address

URL: ${ROOT_URL}/payment/v2.3/ewallet/create

HTTPMethod: POST

EndpointUrl: /payment/v2.3/ewallet/create

E-Money Order Request Parameters

Cara Membuat Signature

Field NameTypeValueRequired
Content-TypeString(30)Nilai fix yakni "application/json;charset=utf-8"Yes
X-TIMESTAMPString(29)Waktu sekarang, menggunakan format ini 2022-09-16T16:58:47.964+07:00Yes
X-SIGNATUREString(64)Signature. Untuk detailnya cekYes
X-PARTNER-IDString(20)Merchant IDYes
X-REQUEST-IDString(64)ID unik merepresentasikan setiap request yang dikirimYes

Body

ParameterTypeRequiredRemarks
requestIdString(64)YesID unik untuk setiap request
merchantIdString(20)YesID unik yang disediakan oleh payment gateway ke merchant
storeIdString(30)NoJika Merchant memiliki cabang dan ingin membuat order dengan ID cabang
paymentTypeString(20)YesTipe Pembayaran, silahkan lihat Tipe Pembayaran
amountDecimal(12,2)YesNominal dalam Rupiah Indonesia
feeTypeString(3)NoJenis pengurangan biaya layanan:BEN、OURStandarnya adalah BEN. Ketika OUR dipilih, biaya layanan akan ditambahkan ke nominal order secara otomatis.
merchantTradeNoString(32)YesKode unik yang dibuat oleh Merchant
notifyUrlString(200)NoURL yang akan diakses oleh API jika pembayaran sukses;
+paymentParamsObjectNoParameter tambahan khusus untuk channel tertentu. Mohon cek tabel Tipe Pembayaran .
productNameString(100)YesNama produk atau layanan
+productInfoArray<Object>(30)NoInformasi detil atas produk atau layanan dalam transaksi
「idString(10)YesProduct ID
「nameString(32)YesProduct Name
「pricedecimal(12,2)YesNilai dalam Rupiah, mendukung dua angka belakang koma
「typeString(20)YesProduct Type
「urlString(200)NoProduct URL
「quantityNumber(4)YesProduct Quantity

paymentType

Payment TypeCode
DANA E-Money (Support Refund)DANABALANCE
Shopee E-Money (Support Refund)SHOPEEBALANCE
Linkaja E-Money (Support Refund)LINKAJABALANCE
OVO E-Money (refunds not supported)OVOBALANCE
GoPay E-Money (Support Refund)GOPAYBALANCE

paymentParams

DANABALANCE, SHOPEEBALANCE, LINKAJABALANCE, GOPAYBALANCE

ParameterTypeRequiredRemarks
redirectUrlString(200)YesBaik saat sukses ataupun gagal, akan diarahkan ke URL tersebut

OVOBALANCE

ParameterTypeRequiredRemarks
redirectUrlString(200)NoBaik saat sukses ataupun gagal, akan diarahkan ke URL tersebut
phoneNumberString(200)NomobilePayUrl tidak akan dikembalikan jika value field ini adalah Nomor HP

E-Money Order Response Parameters

Header

Cara Membuat Signature

Field NameTypeValueRequired
Content-TypeString(30)Isi dengan nilai "application/json;charset=utf-8"Yes
X-TIMESTAMPString(29)Waktu saat ini, dengan format 2022-09-16T16:58:47.964+07:00Yes
X-SIGNATUREString(64)Signature. Untuk selengkapnya cekYes
X-PARTNER-IDString(20)Merchant IDYes
X-REQUEST-IDString(64)ID unik merepresentasikan setiap request yang dikirimYes

Body

ParameterTypeRequiredRemarks
requestIdString(64)YesKode unik untuk setiap request
errCodeString(32)NoUntuk selengkapnya cek bagian Kode Error
errCodeDesString(128)NoDetail error berdasarkan kode error
merchantIdString(20)NoMerchant ID
storeIdString(30)NoHanya diisi jika perlu menggunakan akun channel cabang
paymentTypeString(20)YesTipe pembayaran, cek Tipe Pembayaran
requestAmountDecimal(12,2)NoNominal pada saat permintaan
amountDecimal(12,2)YesNominal transaksi, dalam format Rupiah dengan dua angka belakang komaJenis pengurangan biaya layanan:Ketika OUR dipilih, biaya layanan akan ditambahkan ke nominal order. Ketika biaya layanan yang dihitung mengandung desimal, biaya layanan akan otomatis +1 setelah menghilangkan desimal. Misalnya, 10.000,11 akan secara otomatis +1 untuk mendapatkan 10.001,00.
merchantTradeNoString(32)YesKode unik yang dibuat oleh Merchant untuk setiap transaksi
createTimeString(16)YesyyyyMMddHHmmss
+paymentActionsObjectNoInformasi URL pembayaran yang bisa berupa URL PC, URL Web dan lainnya.
「pcPayUrlString(200)NoPC Payment URL
「mobilePayUrlString(200)NoMobile Payment URL
「appDeeplinkString(200)NoLangsung buka di App
「pushPayString(200)NoUser buka Akun APP untuk konfirmasi pembayaran
platformTradeNoString(32)NoNomor Transaksi Paylabs
successTimeString(16)NoyyyyMMddHHmmss
expiredTimeString(16)NoyyyyMMddHHmmss
statusString(32)No01: Pending, 09: Failed, 02: Success
productNameString(100)YesNama produk atau layanan
+productInfoArray<Object>(30)NoInformasi detil atas produk atau layanan dalam transaksi
「idString(10)YesProduct ID
「nameString(32)YesProduct Name
「pricedecimal(12,2)YesNilai dalam Rupiah, mendukung dua angka belakang koma
「typeString(20)YesProduct Type
「urlString(200)NoProduct URL
「quantityNumber(4)YesProduct Quantity
transFeeRateDecimal(6,6)NoRate Transaksi, mendukung enam angka belakang koma
transFeeAmountDecimal(12,2)NoBiaya, mendukung dua angka belakang koma
totalTransFeeDecimal(12,2)NoTotal rate biaya layanan transaksi (tidak termasuk vatFee), mendukung dua angka belakang koma
vatFeeDecimal(12,2)NoPajak, mendukung dua angka belakang koma
payerString(60)NoNama dari payer yang sebenarnyaJika jenis pembayaran didukung, nama pembayar akan dikembalikan. Jika tidak didukung, nilai null akan dikembalikan.Tidak ada metode pembayaran yang tersedia saat iniCatatan: Bukan “payer” yang dikirim oleh merchant saat memulai permintaan.
accountNoString(32)NoNomor rekening dari payer yang sebenarnyaJika jenis pembayaran didukung, nomor rekening pembayar akan dikembalikan. Jika tidak didukung, nilai null akan dikembalikan.Tidak ada metode pembayaran yang tersedia saat ini

paymentActions Support

ChannelpcPayUrlmobilePayUrlappDeeplinkpushPay
DanaYYNN
ShopeeNYNN
LinkajaYYNN
OVONCNC
GoPayNYNN

Example

Request

POST /payment/v2.3/ewallet/create
# HTTP Header
Content-Type: application/json;charset=utf-8
X-TIMESTAMP: 2022-09-16T16:58:47.964+07:00
X-SIGNATURE: xxxxxxxxx
X-PARTNER-ID: 010001
X-REQUEST-ID: xxxxxxxxxxxxxxxxxxxxxxxx

# HTTP Body
{
  "merchantId":"0010001",
  "merchantTradeNo":"100100011649755299703",
  "requestId":"200100011649755299703",
  "paymentType":"SHOPEEBALANCE",
  "amount":"10000.00",
  "productName":"Test",
  "paymentParams":{
            "redirectUrl": "http://google.com"
        }
}

Response

POST /payment/v2.3/ewallet/create
# HTTP Header
Content-Type: application/json;charset=utf-8
X-TIMESTAMP: 2022-09-16T16:58:47.964+07:00
X-SIGNATURE: xxxxxxxxx
X-PARTNER-ID: 010001
X-REQUEST-ID: xxxxxxxxxxxxxxxxxxxxxxxx

# HTTP Body
{
  "amount":"10000.00",
  "merchantTradeNo":"100100011649755299703",
  "platformTradeNo":"2022041200000000022",
  "expiredTime":"20220412162641",
  "paymentType":"SHOPEEBALANCE",
  "paymentActions":{
            "mobilePayUrl":"https://wsa.uat.wallet.airpay.co.id/universal-link/wallet/pay?deep_and_deferred=1&token=dFhkbmR1bTBIamhWkALJbE72qKeb2LpWAmThwGAMEXu0oo6lQWWCBMbH6JezjfA"
        },
  "createTime":"20220412162143",
  "merchantId":"0010001",
  "errCode":"0",
  "requestId":"200100011649755299703",
  "productName":"Test",
  "status":"01",
  "transFeeRate":"0",
  "transFeeAmount":"0",
  "totalTransFee":"0",
  "vatFee":"0"
}