Account Binding

Berfungsi Untuk menautkan akun SpeedCash ke app milik partner

note

Setelah user berhasil melakukan binding account speedcash akan mengirimkan callback

Service Info

HTTP Method	POST
Service Code	07
Http Method	POST
Path	.../{version}/registration-account-binding

Header

Header Name	Tipe Data	Wajib	Deskripsi
Content-Type	String	Y	application/json
Authorization	String	Y	Token B2B
X-SIGNATURE	String	Y	Dibuat dengan algoritma asymmetric with token B2B : Signature Generation
X-PARTNER-ID	String	Y	Client’s client_id (diberikan pada saat onboarding )
X-EXTERNAL-ID	String	Y	Nomor referensi yang harus unik pada hari yg sama
CHANNEL-ID	String	Y	00001 untuk PJP and 00002 untuk non PJP

Body

Parameter	Tipe Data	Wajib	Deskripsi
msidn	String	Y	Nomor telepon yang akan dibind Length: <= 16 characters
merchantId	String	Y	Identitas merchant Length: <= 15 characters
additionalInfo	Object	Y	Informasi Tambahan
callbackUrl	String	Y	URL callback untuk informasi token akses Length: <= 255 characters
deviceId	String	N	ID perangkat pengguna Length: <= 128 characters

Request samples

JSON

{
  "msidn": "0812xxxxxxxxx",
  "merchantId": "121xxxx",
  "additionalInfo": {
      "callbackUrl": "https://yourapi.com/callback",
      "deviceId": "android-20013adf6xxxxxxxx"
  }
}

CURL

curl --location --request POST '.../v1.0/registration-account-binding' \
--header 'X-TIMESTAMP: 2023-01-17T16:04:00+07:00' \
--header 'X-SIGNATURE: vcQjs/kz5K3Br4gnP9161K8U4EwN0z3E9CRcZkwkZC217O/meyrjxHJSNfJTlhcw+7p/nVxlmKDZHnKiXCDHKg==' \
--header 'X-PARTNER-ID: 085224a9-4b42-4f7d-959f-4452f8a9a1ff' \
--header 'X-EXTERNAL-ID: 42fa4fde-e714-4eef-a9f0-f22a0ac9f3d7' \
--header 'X-DEVICE-ID: 1ea583687a8ac0c776786370baae24bd' \
--header 'CHANNEL-ID: 12345' \
--header 'Authorization: Bearer 59400db8-36f3-4c20-9e7b-1c3f4aa8f7c5' \
--header 'Content-Type: application/json' \
--data {
    "msidn": "0812xxxxxxxxx",
    "merchantId": "121xxxx",
    "additionalInfo": {
        "callbackUrl": "https://yourapi.com/callback"
        "deviceId": "android-20013adf6xxxxxxxx"
    }
}

```

Response Structure

Parameter	Tipe Data	Deskripsi
responseCode	String	Kode response Length: <= 7 characters
responseMessage	String	Deskripsi response Length: <= 150 characters
redirectUrl	String	URL pengalihan sukses merchant Length: <= 2048 characters

Response samples

{
  "responseCode": 2000700,
  "responseMessage": "Succesfull",
  "redirectUrl": ".../binding/xxxxxxxxxxxx"
}

List Response Code Account Binding

Response Code	Response Message	Description
2000700	Success	Sukses
4000701	Invalid field format { field name }	Format invalid
4000702	Invalid mandatory field {field name}	Format pada bidang wajib tidak ada atau tidak valid
4010700	Unauthorized. Invalid Signature	X-Signature salah
4090700	Cannot use same X-EXTERNAL-ID in same day	X-External-ID sudah pernah digunakan di hari yang sama
4040701	Bad Request	Request header ada yang salah / kurang
4040701	Unauthorized. Client Forbidden Access API	Partner tidak dapat mengakses api terkait