Linkage

Account Creation

Account Creation merupakan service yang disediakan untuk Anda membuat akun baru agar dapat melakukan transaksi atau mengelola dana.
Tipe Value
Kode Layanan
06
Nama
API Account Creation
HTTP Method
POST

Flow

Anda melakukan permintaan dengan mengirimkan parameter yang dibutuhkan, dan Espay Payment Gateway akan memberikan respons dalam bentuk JSON.

API URL

Environment URL
Sandbox
Port of HTTPS (443)
https://sandbox-api.espay.id/apidirectdebit/v1.0/registration-account-creation
Production
Port of HTTPS (443)
https://api-merchant.espay.id/apidirectdebit/v1.0/registration-account-creation
Nama Tipe Mandatory Keterangan
Content-Type
String
Y
Isi konten permintaan Anda.

Contoh:
application/json
X-TIMESTAMP
String (25)
Y
Tanggal dan waktu lokal customer saat ini.

Format:
yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

Contoh:
2024-03-14T07:49:28+07:00
X-SIGNATURE
String (255)
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Payment Gateway | Asymmetric Signature
X-EXTERNAL-ID
String (32)
Y
String Numerik. Kode referensi yang bersifat unik pada hari yang sama.
X-PARTNER-ID
String (50)
Y
Merchant code yang diberikan oleh tim Espay.
CHANNEL-ID
String (5)
Y
Kode channel.

Value:
ESPAY
Authorization-Customer
String (150)
C
Kode token B2B2C. Khusus Espay -> Bank.
Y: Yes, O: Optional, C: Conditional

Parameter Permintaan

Parameter Tipe Mandatory Keterangan
partnerReferenceNo
String (64)
Y
Kode referensi dari mitra.

Contoh:
2020102900000000000001.
name
String (128)
Y
Nama lengkap customer.

Contoh:
Jhon Doe
phoneNo
String (16)
Y
Nomor handphone customer.

Format:
62xxxxxxxxxxxx
email
String (254)
Y
Email customer.

Contoh:
[email protected]
customerId
String (45)
Y
ID unik customer yang berisi numerik.

Contoh:
9674126689000299
additionalInfo
Object
  productCode
String (16)
C
Kode produk.

Value:
EWALLETDIRECTDEBIT
  customerIdType
String (25)
C
Jenis identitas customer.

Format:
  • KTP
  • SIM
  • PASPOR
  custReligion
String (25)
C
Agama customer.

Format:
  • ISLAM
  • KRISTEN
  • KRISTEN PROTESTAN
  • KATOLIK
  • HINDU
  • BUDDHA
  • KHONGHUCU
  dateOfBirth
Date
C
Tanggal lahir customer.

Format:
YYYY-MM-DD.

Contoh:
2007-09-01.
  custBirthPlace
String (40)
C
Tempat lahir customer.

Contoh:
Jakarta
  custAddress
String (200)
C
Alamat customer.
  custGender
String (25)
C
Jenis kelamin customer

Format:
  • Perempuan: P
  • Laki-Laki: L
  custMarriageStatus
String (2)
C
Status perkawinan customer.

Format:
  • Kawin: K
  • Belum Kawin: BK
  • Cerai: C
  • Cerai Mati: CM
  custNationality
String (25)
C
Kewarganegaraan customer.

Contoh:
WNI
  custProvinsi
String (40)
C
Provinsi tempat tinggal customer.

Contoh:
DKI Jakarta
  custKabupaten
String (40)
C
Kabupaten tempat tinggal customer.

Contoh:
Jakarta Pusat
  custKecamatan
String (40)
C
Kecamatan tempat tinggal customer.

Contoh:
Menteng
  custKelurahan
String (40)
C
Kelurahan tempat tinggal customer.

Contoh:
Cikini
  custRT
String (5)
C
RT tempat tinggal customer.
  custRW
String (5)
C
RW tempat tinggal customer.
  custOccupation
String (40)
C
Pekerjaan customer.
  ktpPhoto
String (2048)
C
KTP customer dalam bentuk gambar.

Format:
  • JPEG/PNG
  selfiePhoto
String (2048)
C
Swafoto (selfie) customer.

Format:
  • JPEG/PNG
  signaturePhoto
String (2048)
C
Tanda tangan customer dalam bentuk gambar.

Format:
  • JPEG/PNG
Y: Yes, O: Optional, C: Conditional

Parameter Respons

Parameter Tipe Mandatory Keterangan
responseCode
String (7)
Y
Kode respons. Lihat kode respons di sini.

Format:
Kode HTTP + Kode Layanan + Kode Error

Contoh:
200+06+00 = 2000600.
responseMessage
String (150)
Y
Deskripsi respons. Lihat deskripsi respons di sini.
phoneNo
String (16)
Y
Nomor handphone customer.

Format:
62xxxxxxxxxxxx
referenceNo
String (64)
Y
ID unik yang dibuat oleh Espay, dan akan terisi saat kondisi berhasil.
additionalInfo
Object
  webRedirectUrl
String (2048)
O
URL untuk redirect ke halaman E-wallet.

Format:
Urlencode
  originalUrl
String (2048)
O
URL untuk redirect ke halaman E-wallet.

Format:
Plain Text
Parameter Tipe Mandatory Keterangan
responseCode
String (7)
Y
Kode respon.

Format:
Kode HTTP + Kode Layanan + Kode Error

Contoh:
200+06+00 = 2000600.
responseMessage
String (150)
Y
Deskripsi respon.
referenceNo
String (64)
Y
ID unik yang dibuat oleh Espay, dan akan terisi saat kondisi berhasil.
partnerReferenceNo
String (64)
C
ID unik yang dibuat oleh merchant.
authCode
String
O
Kode otorisasi untuk mendapatkan accessToken dan agreementToken.
apiKey
Numeric
O
ID pelanggan dalam format numerik.
accountId
String (32)
O
ID akun pengguna.
additionalInfo
Object
  custId
String
O
ID customer.

Format:
Nomor handphone

Contoh:
62878123987
  ktpPhotoUrl
String
O
URL lokasi file foto KTP yang diunggah.
  selfiePhotoUrl
String
O
URL lokasi file foto swafoto (selfie) yang diunggah.
  signaturePhotoUrl
String
O
URL lokasi file foto tanda tangan yang diunggah.
Y: Yes, O: Optional, C: Conditional





























Contoh Header

Content-Type:application/json
X-TIMESTAMP:2024-03-14T07:49:28+07:00
X-SIGNATURE:jaCUbDOSIjFcDaZ1rO0aCczJrWSfV0wAXVi/zOLlOLOIVH00gucOSOnHpKTARwpnn6qB08Vi8VJviNhIQh1q6zVJAwdhxnHRlwNFa28IVFTtSmD4nXPWT3LsuYuFPNDGJ59/MgKMVjwIofYvq2dwOHoDi9rnyT3nPl7N2bRdIQceQlD6sITcqdEbRUlm+zTFB2MxNy4vFaEZz1LU8fsENp+giMNqxR26DsNcRj1K8JBXO6nY8q2m3jmTmiduXK5VZXxt/5v6bp+OlYCwJhn3hmdZD1zwC3Hu6qZcCIhO6IVe0ThSCfsaCdye9o/Ew6VdMWbTtQUoR983mq6MubLmzg==
X-EXTERNAL-ID:d3be5aec-155b-4b46-bfee-3fd55363d0f4
X-PARTNER-ID:SGWYESSISHOP
CHANNEL-ID:ESPAY




























Contoh Permintaan

{
    "partnerReferenceNo":"TESTING010",
    "name": "Putra",
    "phoneNo": "62821378692136",
    "email": "[email protected]",
    "customerId": "31710499994222",
    "additionalInfo": {
        "productCode": "EWALLETIRECTDEBIT",
        "productCode": "EWALLETIRECTDEBIT",
        "customerIdType": "KTP",
        "custReligion": "KRISTEN PROTESTAN",
        "dateOfBirth": "1999-01-30",
        "custBirthPlace": "TANGERANG", 
        "custAddress": "JL. TEST 01",
        "custGender": "L",
        "custMarriageStatus": "BK",
        "custNationality": "WNI",
        "custProvinsi": "DKI JAKARTA",
        "custKabupaten": "KOTA JAKARTA PUSAT",
        "custKecamatan": "SENEN", 
        "custKelurahan": "PASEBAN", 
        "custRT": "11",
        "custRW": "12",
        "custOccupation": "karyawan",
        "ktpPhoto": "1.jpg",
        "selfiePhoto": "2.jpg",
        "signaturePhoto": "3.jpg"
    }
}

































































































Contoh Respons Positif

{
    "responseCode": "2020600",
    "responseMessage": "Request In Progress",
    "phoneNo": "62821378692136",
    "referenceNo": "56d3b9d2-604f-47a9-89aa-03c11cfdb19e",
    "additionalInfo": {
        "webRedirectUrl": "https%3A%2F%2Fapiewallet-dev.ewallet.com%2Fuser%2Faccount%2Faccount-creation-create-pin%3Fauth%3DurStnr173319921756d3b9d2-604f-47a9-89aa-03c11cfdb19e",
        "originalUrl": "https://apiewallet-dev.ewallet.com/user/account/account-creation-create-pin?auth=urStnr173319921756d3b9d2-604f-47a9-89aa-03c11cfdb19e"
    }
}


Contoh Respons Negatif

{
    "responseCode": "4090600",
    "responseMessage": "Duplicate X-EXTERNAL-ID"
}



CURL

curl --location 'https://sandbox-api.espay.id/apidirectdebit/v1.0/registration-account-creation' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2024-03-14T07:49:28+07:00' \
--header 'X-SIGNATURE: jaCUbDOSIjFcDaZ1rO0aCczJrWSfV0wAXVi/zOLlOLOIVH00gucOSOnHpKTARwpnn6qB08Vi8VJviNhIQh1q6zVJAwdhxnHRlwNFa28IVFTtSmD4nXPWT3LsuYuFPNDGJ59/MgKMVjwIofYvq2dwOHoDi9rnyT3nPl7N2bRdIQceQlD6sITcqdEbRUlm+zTFB2MxNy4vFaEZz1LU8fsENp+giMNqxR26DsNcRj1K8JBXO6nY8q2m3jmTmiduXK5VZXxt/5v6bp+OlYCwJhn3hmdZD1zwC3Hu6qZcCIhO6IVe0ThSCfsaCdye9o/Ew6VdMWbTtQUoR983mq6MubLmzg==' \
--header 'X-EXTERNAL-ID: c8cab3ec-9e64-43fb-95a4-8fb41ad135e5' \
--header 'X-PARTNER-ID: SGWYESSISHOP' \
--header 'CHANNEL-ID: ESPAY' \
--data-raw '{
    "partnerReferenceNo":"TESTING010",
    "name": "Putra",
    "phoneNo": "62821378692136",
    "email": "[email protected]",
    "customerId": "31710499994222",
    "additionalInfo": {
        "productCode": "SALDOMUDIRECTDEBIT",
        "customerIdType": "KTP",
        "custReligion": "KRISTEN PROTESTAN",
        "dateOfBirth": "1999-01-30",
        "custBirthPlace": "TANGERANG", 
        "custAddress": "JL. TEST 01",
        "custGender": "L",
        "custMarriageStatus": "BK",
        "custNationality": "WNI",
        "custProvinsi": "DKI JAKARTA",
        "custKabupaten": "KOTA JAKARTA PUSAT",
        "custKecamatan": "SENEN", 
        "custKelurahan": "PASEBAN", 
        "custRT": "11",
        "custRW": "12",
        "custOccupation": "karyawan",
        "ktpPhoto": "1.jpg",
        "selfiePhoto": "2.jpg",
        "signaturePhoto": "3.jpg"
    }
}'
Scroll to Top