> For the complete documentation index, see [llms.txt](https://docs.kredibel.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kredibel.io/api-references/electronic-certificate/certificate-issuance.md). # Certificate Issuance {% hint style="info" %} This module only support verification for indonesian identity card (KTP) {% endhint %} ## {% embed url="" %} ## Endpoints | Method | URL | | ------ | ----------------------------------------- | | POST | `$synapses`**`/v1/certificate/issuance`** | ### Headers | Header | Value | | --------------- | ----------------------------------------------- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer` [`YOUR_API_KEY`](/authentication-1.md) | ### **Request** {% tabs %} {% tab title="Description" %} | Field | Type | Description | | ---------------------------------------------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------- | |

identityId

(required)

|

String
(len: 16)

| Nomor induk kependudukan (NIK) based on the identity card. | |

fullName

(required) | | |

| `String` | Full name based on the identity card. | |

birthDate
(required)

|

String
(format: yyyy-mm-dd)

| Birth Date based on the identity card. | |

emailAddress
(required)

| `String` | Email address (must be unique per NIK). | |

phoneNumber
(required)

| `String` | Valid phone number, use country code but without symbol (+), (must be unique per nik). | |

faceImage

(required)

| `Base64` |

Selfie photo of the identity card holder.

Image binary encoded in base64 without <data:image/png;>.
- Supports: JPG, JPEG, PNG, SVG
- Min Size: 100KB
- Max Size: 4MB
- Min Pixel: 480px x 640px

| |

identityImage

(required)

| `Base64` |

Identity card photo.

Image binary encoded in base64 without <data:image/png;>.
- Supports: JPG, JPEG, PNG, SVG
- Min Size: 100KB
- Max Size: 2MB
- Min Pixel: 480px x 360px

| {% endtab %} {% tab title="Example" %} ``` { "identityId": "1234567890123456", "fullName": "ASEP SUPRIYADI", "birthDate": "1990-07-06", "emailAddress": "test@email.com", "phoneNumber": "621234567890", "faceImage": "", "identityImage": "" } ``` {% endtab %} {% endtabs %} #### **Testing** {% hint style="info" %} In the sandbox environment, we only response api call with dummy data. To get valid response data, you can use our production environment instead. {% endhint %} {% tabs %} {% tab title="All Match" %} You can use any identityId to produce verified status. **Example:** ``` { "identityId": "1234567890123456", "fullName": "ASEP SUPRIYADI", "birthDate": "1990-07-06", "emailAddress": "test@email.com", "phoneNumber": "621234567890", "faceImage": "", "identityImage": "" } ``` ``` { "message": "Certificate electronic verification has been done", "data": { "id": "8c4d6927-b4e1-428b-b95f-c21b6734b73f", "status": "verified", "rejectFields": [], "referenceId": "ref_certel#e87c8bc2-5d10-455b-98a0-187d60f72873" } } ``` {% endtab %} {% tab title="Invalid NIK" %} You can use identityId =`1234567890111111` to produce invalid identityId. **Example:** ``` { "identityId": "1234567890111111", "fullName": "ASEP SUPRIYADI", "birthDate": "1990-07-06", "emailAddress": "test@email.com", "phoneNumber": "621234567890", "faceImage": "", "identityImage": "" } ``` ``` { "message": "Certificate electronic verification has been done", "data": { "id": "93db29c0-ca66-4803-aa70-537439c9cfff", "status": "not_verified", "rejectFields": [ "identityId" ], "referenceId": "ref_certel#3c42fa6b-c2c9-4705-8117-cf9d08c8d2aa" } } ``` {% endtab %} {% tab title="Invalid Name" %} You can use identityId =`1234567890111112` to produce invalid fullName. **Example:** ``` { "identityId": "1234567890111112", "fullName": "ASEP SUPRIYADI", "birthDate": "1990-07-06", "emailAddress": "test@email.com", "phoneNumber": "621234567890", "faceImage": "", "identityImage": "" } ``` ``` { "message": "Certificate electronic verification has been done", "data": { "id": "716ccf7d-4620-4146-b889-8c660cc8f280", "status": "not_verified", "rejectFields": [ "fullName" ], "referenceId": "ref_certel#8c679bd3-087b-49f7-bdd6-3f5c6300a927" } } ``` {% endtab %} {% tab title="Invalid Birth Date" %} You can use identityId=`1234567890111113` to produce invalid birthDate. **Example:** ``` { "identityId": "1234567890111113", "fullName": "ASEP SUPRIYADI", "birthDate": "1990-07-06", "emailAddress": "test@email.com", "phoneNumber": "621234567890", "faceImage": "", "identityImage": "" } ``` ``` { "message": "Certificate electronic verification has been done", "data": { "id": "bba69765-371c-45ac-b673-4bb36f07ab9c", "status": "not_verified", "rejectFields": [ "birthDate" ], "referenceId": "ref_certel#763f7342-66f6-47eb-87d2-e9a11378d911" } } ``` {% endtab %} {% tab title="Invalid Face Image" %} You can use identityId=`1234567890111114` to produce invalid face image. **Example:** ``` { "identityId": "1234567890111114", "fullName": "ASEP SUPRIYADI", "birthDate": "1990-07-06", "emailAddress": "test@email.com", "phoneNumber": "621234567890", "faceImage": "", "identityImage": "" } ``` ``` { "message": "Certificate electronic verification has been done", "data": { "id": "a940e1e9-22f0-4154-8b0f-6219b417a6b1", "status": "not_verified", "rejectFields": [ "faceImage" ], "referenceId": "ref_certel#8c946fc0-5ac2-4120-9ee5-415baf0b0e3a" } } ``` {% endtab %} {% tab title="Invalid Identity Image" %} You can use identityId=`1234567890111115` to produce invalid identityImage. **Example:** ``` { "identityId": "1234567890111115", "fullName": "ASEP SUPRIYADI", "birthDate": "1990-07-06", "emailAddress": "test@email.com", "phoneNumber": "621234567890", "faceImage": "", "identityImage": "" } ``` ``` { "message": "Certificate electronic verification has been done", "data": { "id": "3e37f95d-a1e8-4d89-8f0c-0f267ea0a36a", "status": "not_verified", "rejectFields": [ "identityImage" ], "referenceId": "ref_certel#8c946fc0-5ac2-4120-9ee5-415baf0b0e2s" } } ``` {% endtab %} {% tab title="Invalid Email Address" %} {% hint style="info" %} It means that the email, phone number, or both have been used by another NIK (identification number). {% endhint %} You can use identityId=`1234567890111116` to produce invalid emailAddress. **Example:** ``` { "identityId": "1234567890111116", "fullName": "ASEP SUPRIYADI", "birthDate": "1990-07-06", "emailAddress": "test@email.com", "phoneNumber": "621234567890", "faceImage": "", "identityImage": "" } ``` ``` { "message": "Certificate electronic verification has been done", "data": { "id": "368fea8e-0fad-4bc3-8ef6-fa2d8585d1d7", "status": "verified_with_reason", "rejectFields": [ "emailAddress" ], "referenceId": "ref_certel#dfb8b449-4d83-41e8-b2f4-0343ead765f4" } } ``` {% endtab %} {% tab title="Invalid Phone Number" %} {% hint style="info" %} It means that the email, phone number, or both have been used by another NIK (identification number). {% endhint %} You can use identityId=`1234567890111117` to produce invalid phoneNumber. **Example:** ``` { "identityId": "1234567890111117", "fullName": "ASEP SUPRIYADI", "birthDate": "1990-07-06", "emailAddress": "test@email.com", "phoneNumber": "621234567890", "faceImage": "", "identityImage": "" } ``` ``` { "message": "Certificate electronic verification has been done", "data": { "id": "a67c4ab8-c723-49f1-a2a8-e7a579df94f7", "status": "verified_with_reason", "rejectFields": [ "phoneNumber" ], "referenceId": "ref_certel#a704a3ad-1986-4897-975e-16e015d88b2e" } } ``` {% endtab %} {% tab title="Invalid Email Address & Phone Number" %} {% hint style="info" %} It means that the email, phone number, or both have been used by another NIK (identification number). {% endhint %} You can use identityId=`1234567890111118` to produce invalid Email Address & phoneNumber. **Example:** ``` { "identityId": "1234567890111118", "fullName": "ASEP SUPRIYADI", "birthDate": "1990-07-06", "emailAddress": "test@email.com", "phoneNumber": "621234567890", "faceImage": "", "identityImage": "" } ``` ``` { "message": "Certificate electronic verification has been done", "data": { "id": "d35484cc-7f49-4d23-8fdd-3052fd96c8b6", "status": "verified_with_reason", "rejectFields": [ "phoneNumber", "emailAddress" ], "referenceId": "ref_certel#3c42fa6b-c2c9-4705-8117-cf9d08c8d2aa" } } ``` {% endtab %} {% tab title="Liveness Error" %} {% hint style="info" %} Failed because of liveness check, only liveness will be charged {% endhint %} You can use identityId=`1234567890111119` to produce liveness error. **Example:** ``` { "identityId": "1234567890111119", "fullName": "ASEP SUPRIYADI", "birthDate": "1990-07-06", "emailAddress": "test@email.com", "phoneNumber": "621234567890", "faceImage": "", "identityImage": "" } ``` ``` { "message": "Certificate electronic verification has been done", "data": { "id": "36a6ed7b-cd7a-44d7-b4d2-d181cf561ea3", "status": "not_verified", "rejectFields": [ "liveness_check" ], "referenceId": "ref_certel#3c42fa6b-c2c9-4705-8117-cf9d08c8d2aa" } } ``` {% endtab %} {% endtabs %} ### **Response** {% tabs %} {% tab title="Description" %} | Field | Type | Description | | ------------ | -------- | ------------------------------------------------------------------------------------------------------------------ | | id | `String` | Kredibel history id (unique for every transactions). | | status | `String` |

Identifier of the transaction status:

- verified

- verified\_with\_reason

- not\_verified

| | rejectFields | `Array` | Indicator if there’s a false response to a or any parameter, example if nik. | | referenceId | `String` | Reference id. | | {% endtab %} | | | {% tab title="Example" %} ``` { "message": "Certificate electronic verification has been done", "data": { "id": "8c4d6927-b4e1-428b-b95f-c21b6734b73f", "status": "verified", "rejectFields": [], "referenceId": "ref_certel#e87c8bc2-5d10-455b-98a0-187d60f72873" } } ``` {% endtab %} {% endtabs %} ### **Errors** {% hint style="info" %} Please read this [page \](/responses-and-errors.md) to know more about response. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.kredibel.io/api-references/electronic-certificate/certificate-issuance.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.