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.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 Signature Asymmetric
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:
john.doe@email.com
customerId
String (45)
Y
ID unik customer yang berisi numerik.

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

Value:
SALDOMUDIRECTDEBIT
  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
  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
Parameter Tipe Mandatory Keterangan
partnerReferenceNo
String (64)
Y
Kode referensi dari mitra.

Contoh:
2020102900000000000001.
countryCode
String (2)
Y
Kode negara.

Format:
ISO 3166-1 Alpha 2

Contoh:
ID
customerId
String (45)
Y
ID unik customer yang berisi angka dan karakter alfanumerik.

Contoh:
00-abcghijkwxyz0123456789-11.
email
String (254)
Y
Email customer.

Contoh:
john.doe@email.com
lang
String (8)
Y
Kode bahasa yang digunakan.

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

Contoh:
John Doe
onboardingPartner
String (8)
Y
Nama mitra onboarding.

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

Format:
62xxxxxxxxxxxx
redirectUrl
String (2048)
Y
URL pengalihan yang digunakan setelah proses selesai.

Contoh:
https://merchant.site.com/apptoken
terminalType
String (32)
Y
Tipe terminal yang digunakan.

Contoh:
SYSTEM
additionalInfo
Object
  deviceId
String
Y
ID perangkat customer.

Contoh:
123456792321
  channel
String
Y
Kanal yang digunakan untuk permintaan.

Contoh:
Mobilephone
  rcUuid
String
Y
UUID dari sesi permintaan.

Contoh:
1069a3eb-65f4-4d02-a15b-16352a7ac25f
  commId
String
Y
ID komunikasi unik.

Contoh:
EMOSALDOMU1500439694RS6DD
  signature
String (255)
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Signature Asymmetric
  appSecretKey
String
Y
Kunci rahasia aplikasi.

Contoh:
cd66dad6fc87651a14a1936a83.
  isRegister
String
Y
Status terdaftar.

Value:
"Y"
  appId
String
Y
ID aplikasi.

Contoh:
SDOM.
  custPIN
String
Y
PIN customer.
  custPassword
String
Y
Kata sandi customer.
  custBirthDate
String
Y
Tanggal lahir customer.

Format:
YYYY-MM-DD.

Contoh:
2007-09-01.
  motherName
String
Y
Nama ibu kandung customer.
  custRW
String
Y
RW tempat tinggal customer.
  custRT
String
Y
RT tempat tinggal customer.
  custOccupation
String
Y
Pekerjaan customer.
  custGender
String
Y
Jenis kelamin customer.

Contoh:
Perempuan
  custKelurahan
String
Y
Kelurahan tempat tinggal customer.

Contoh:
Paseban
  custBirthPlace
String
Y
Tempat lahir customer.

Contoh:
Jakarta
  bankCode
String
Y
Kode bank. Klik disini
  custMarriageStatus
String
Y
Status perkawinan user.

Contoh:
BELUM KAWIN
  custAddress
String
Y
Alamat customer.
  custKecamatan
String
Y
Kecamatan tempat tinggal customer.

Contoh:
Senen
  userId
String
Y
ID customer.

Format:
Nomor Handphone.

Contoh:
62878123987.
  custCountry
String
Y
Negara tempat tinggal customer.
  custNationality
String
Y
Kewarganegaraan customer.

Contoh:
WNI
  custProvinsi
String
Y
Provinsi tempat tinggal customer.

Contoh:
DKI Jakarta.
  custId
String
Y
ID customer.

Contoh:
62878123987.
  custIdType
String
Y
Jenis identitas customer.

Contoh:
KTP
  custReligion
String
Y
Agama customer.

Contoh:
ISLAM
  ktpPhoto
String
Y
KTP customer dalam bentuk gambar.

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

Format:
  • JPEG/PNG
  signaturePhoto
String
Y
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 respon.

Format:
Kode HTTP + Kode Layanan + Kode Error

Contoh:
200+06+00 = 2000600.
responseMessage
String (150)
Y
Deskripsi respon.
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 Saldomu.

Format:
Urlencode
  originalUrl
String (2048)
O
URL untuk redirect ke halaman Saldomu.

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": "test@sgo.co.id",
    "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"
    }
}































































































Contoh Respons

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







CURL


......





Scroll to Top