Submissions
Berfungsi untuk melakukan upload dokumen KYC
info
Saat melakukan Generate Signature untuk field bertipe image tidak ikut digenerate dalam signature
Service Info
| HTTP Method | POST |
|---|---|
| Service Code | 97 |
| Http Method | POST |
| Path | ...{version}/kyc/submissions |
Header
| Header Name | Tipe Data | Wajib | Deskripsi |
|---|---|---|---|
| Content-Type | String | Y | multipart/form-data |
| Authorization | String | Y | Token B2B |
| Authorization-Customer | String | Y | Token B2B2C |
| X-TIMESTAMP | String | Y | Waktu lokal klien saat ini dalam format yyyy-MM-ddTHH:mm:ss+07:00. |
| X-SIGNATURE | String | Y | Dibuat dengan algoritma asymmetric with token B2B2C: 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 |
|---|---|---|---|
| fullName | String | Y | Nama Lengkap |
| identityCardNumber | String | Y | nomor ktp (NIK) Length: <= 16 karakter |
| merchantId | String | Y | Pengidentifikasi merchant yang unik untuk setiap merchant Length: <= 64 karakter |
| dateOfBirth | String | Y | Tahun Tanggal lahir Length: <= 25 karakter |
| idCardImage | File | Y | Foto KTP Size : <= 15MB Format: JPEG/PNG |
| selfieImage | File | Y | Foto Selfie Size : <= 15MB Format: JPEG/PNG |
Request samples
- JSON
- CURL
{
"fullName": "tanjiro",
"identityCardNumber": "31234524xxxxxxxx",
"merchantId": "12xxxx",
"dateOfBirth": "2025-01-09",
"idCardImage": "file",
"selfieImage": "file"
}
curl --location --request POST '.../v1.0/kyc/submissions' \
--header 'x-timestamp: 2025-08-05T01:40:28.221Z' \
--header 'x-signature: kbjxoYYq+AXZcRsJJnOxjGZVhEqYQ8PvRLeCiCfnr0C34qkA/krnUDhyiYy7K3ZhdXREkG9dMWB/NEDB5uHmOw==' \
--header 'x-partner-id: 130f3996-c89d-415c-8ee6-5e4fe52ed51b' \
--header 'channel-id: 3213213123' \
--header 'x-external-id: {{externalId}}' \
--header 'authorization-customer: Bearer 827bf20a-0864-413b-92ae-52a6a1a4deb4' \
--header 'Authorization: Bearer 93e6a446-0777-43da-afd1-ae3eb8f080ab' \
--form 'idCardImage=@"/pexels-tomfisk-1519753.jpg"' \
--form 'selfieImage=@"/cutecat.jpg"' \
--form 'fullName="tanjiro"' \
--form 'identityCardNumber="31234524xxxxxxxx"' \
--form 'merchantId="12xxxx"' \
--form 'dateOfBirth="2025-01-09"'
Response Structure
| Parameter | Tipe Data | Deskripsi |
|---|---|---|
| responseCode | String | Kode respons Length: <= 7 karakter |
| responseMessage | String | Deskripsi respons Length: <= 150 karakter |
Response samples
{
"responseCode": "2009700",
"responseMessage": "Successfully"
}
List Response Code API KYC Submissions
| Response Code | Response Message | Description |
|---|---|---|
| 2009700 | Success | Sukses |
| 4009701 | Invalid field format { field name } | Format invalid |
| 4009702 | Invalid mandatory field {field name} | Format pada bidang wajib tidak ada atau tidak valid |
| 4019700 | Unauthorized. Invalid Signature | X-Signature salah |
| 4019701 | Invalid Token, Token found in request is invalid | Token B2B invalid |
| 4019702 | Invalid Customer Token, Token found in request is invalid | Token B2B2C invalid |
| 4099700 | Cannot use same X-EXTERNAL-ID in same day | X-External-ID sudah pernah digunakan di hari yang sama |
| 4049701 | Bad Request | Request header ada yang salah / kurang |
| 4049701 | Unauthorized. Client Forbidden Access API | Partner tidak dapat mengakses api terkait |
| 4009703 | File upload error: {} | Terjadi Kesalahan Upload File, bisa dari size / format yang tidak sesuai |
| 4099701 | Duplicate Documents, request has previously been processed indicates the same documents already process or success | Sudah upload dokumen sebelumnya dan sedang di proses |
| 4039701 | Duplicate identityCardNumber already used | nomor ktp / NIK sudah pernah terdaftar |