Status
Berfungsi untuk melihat status dari dokumen KYC
Service Info
| HTTP Method | POST |
|---|---|
| Service Code | 98 |
| Http Method | POST |
| Path | ...{version}/kyc/state |
Header
| Header Name | Tipe Data | Wajib | Deskripsi |
|---|---|---|---|
| Content-Type | String | Y | application/json |
| 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 |
|---|---|---|---|
| merchantId | String | Y | Pengidentifikasi merchant yang unik untuk setiap merchant Length: <= 64 karakter |
Request samples
- JSON
- CURL
{
"merchantId": "12xxxx",
}
curl --location --request POST .../v1.0/kyc/state' \
--header 'x-timestamp: 2025-08-05T02:04:16.695Z' \
--header 'x-signature: AlocP/7NiJ82l/CWw5UymOEgmOzSo+Q3zshjN3ZiOjlx7aoCXBbrgpt3eC134hoEaaU5+i4fJnR9Fm8eSPKEGQ==' \
--header 'x-partner-id: 130f3996-c89d-415c-8ee6-5e4fe52ed51b' \
--header 'channel-id: 3213213123' \
--header 'x-external-id: {{externalId}}' \
--header 'authorization-customer: Bearer ff33339e-841a-4ed3-a23a-9659dbe47a84' \
--header 'Authorization: Bearer 759ee6cc-76ca-4b90-a180-30a082a5a3aa' \
--header 'Content-Type: application/json' \
--data-raw '{
"merchantId" : "1212xxxx"
}'
Response Structure
| Parameter | Tipe Data | Deskripsi |
|---|---|---|
| responseCode | String | Kode respons Length: <= 7 karakter |
| responseMessage | String | Deskripsi respons Length: <= 150 karakter |
| additionalInfo | Object | Informasi Tambahan |
| status | Integer | Status KYC 0 - Belum verifikasi dokumen 1 - Berhasil verifikasi dokumen 2 - Verifikasi dokumen di tolak 3 - Verifikasi dokumen sedang dalam proses |
| account_desc | String | Keterangan dokumen Length: <= 255 karakter |
Response samples
{
"responseCode": "2009800",
"responseMessage": "Akun Anda Berhasil Di Verifikasi",
"additionalInfo": {
"status": 1,
"account_desc": "Dokumen Anda <b>telah sukses</b> diverifikasi oleh admin"
}
}
List Response Code API KYC Submissions
| Response Code | Response Message | Description |
|---|---|---|
| 2004800 | Success | Sukses |
| 4004801 | Invalid field format { field name } | Format invalid |
| 4004802 | Invalid mandatory field {field name} | Format pada bidang wajib tidak ada atau tidak valid |
| 4014800 | Unauthorized. Invalid Signature | X-Signature salah |
| 4094800 | Cannot use same X-EXTERNAL-ID in same day | X-External-ID sudah pernah digunakan di hari yang sama |
| 4044801 | Bad Request | Request header ada yang salah / kurang |
| 4044801 | 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 |