Hasil verifikasi melalui Status API

Mitra dapat memeriksa status verifikasi melalui endpoint API status verifikasi kami (GET /api/partner/v2/verify/requests/{id}). Endpoint ini mengembalikan hasil verifikasi dan informasi kredensial untuk permintaan verifikasi tertentu.

Autentikasi memerlukan token JWT dari endpoint token OAuth kami, dan API membutuhkan ID permintaan yang dibuat saat permintaan verifikasi asli diajukan.

Status

Status	Deskripsi
`incomplete`	Verifikasi sedang berlangsung. Tidak ada hasil yang tersedia pada tahap ini.
`canceled`	Verifikasi tidak lagi dilanjutkan dan tidak ada hasil yang tersedia.
`verified`	Verifikasi berhasil diselesaikan dan hasil tersedia.
`revoked`	Hasil verifikasi tidak valid. Semua salinan hasil harus dihapus.
`unshared`	Hasil verifikasi tidak tersedia. Ini terjadi ketika pengguna meminta pembagian diakhiri, atau belum menyetujui untuk membagikan kredensial yang diperbarui.

Silakan merujuk ke Spesifikasi OpenAPI V2 kami untuk detail lebih lanjut tentang format permintaan dan respons.

Contoh permintaan

Contoh hasil verifikasi: Kredensial terverifikasi

# GET /api/partner/v2/verify/requests/7cbc7e51-82f5-43ec-8d63-b7cdf1170425

{
    "request_id": "7cbc7e51-82f5-43ec-8d63-b7cdf1170425",
    "created_at": "2026-03-11T23:44:03.863583Z",
    "results": [
        {
            "credential_type": "digital_identity",
            "status": "verified",
            "verified_at": "2026-03-12T00:27:46.657218Z",
            "digital_identity": {
                "full_name": "John Smith"
            }
        }
    ]
}

Contoh hasil verifikasi: Verifikasi tidak lengkap

{
    "request_id": "9a98ba28-cd63-43d4-9959-9c593700c7da",
    "created_at": "2026-01-20T02:43:09.440220Z",
    "results": [
        {
            "credential_type": "digital_identity",
            "status": "incomplete"
        }
    ]
}

Contoh hasil verifikasi: Verifikasi dibatalkan

{
    "request_id": "793a798c-92ac-4b5f-9866-ef73e6b4c6d9",
    "created_at": "2026-01-20T02:43:09.440220Z",
    "results": [
        {
            "credential_type": "digital_identity",
            "status": "canceled"
        }
    ]
}

API Status Massal

API status massal juga tersedia untuk menanyakan status beberapa permintaan verifikasi secara bersamaan. Hingga 30 ID permintaan dapat disertakan dalam satu kueri.

Karena batasan ukuran kueri maksimum, bergantung pada panjang ID yang diberikan, Anda mungkin menerima respons 403 Forbidden jika string kueri Anda lebih panjang dari 2048 byte. Jika Anda mencapai batas ini, silakan kurangi jumlah ID kueri yang diteruskan dalam permintaan Anda dan coba lagi.

# GET /api/partner/v2/verify/requests?request_id[]=25055614-f707-47cc-b7ed-1724c04dcd05&request_id[]=9a98ba28-cd63-43d4-9959-9c593700c7da
{
    "requests": [
        {
            "request_id": "9a98ba28-cd63-43d4-9959-9c593700c7da",
            "created_at": "2026-01-20T02:43:09.440220Z",
            "results": [
                {
                    "credential_type": "digital_identity",
                    "status": "incomplete"
                }
            ]
        },
        {
            "request_id": "25055614-f707-47cc-b7ed-1724c04dcd05",
            "created_at": "2025-12-18T06:34:34.338171Z",
            "results": [
                {
                    "credential_type": "digital_identity",
                    "status": "verified",
                    "verified_at": "2025-12-18T07:26:01.571197Z",
                    "digital_identity": {
                        "full_name": "John Smith"
                    }
                }
            ]
        }
    ]
}

Uji alur verifikasi

Mitra dengan pengujian yang diaktifkan dapat menguji alur verifikasi di lingkungan staging menggunakan hasil yang telah ditentukan sebelumnya. Atur display_options.partner_name ke salah satu nilai tes yang didukung di bawah ini. Nilai NZDL yang ditampilkan adalah contoh.

Skenario tes	Contoh nilai `partner_name`	Hasil yang diharapkan
Terverifikasi	`Partner.Verified.NZDL`	Untuk contoh ini, API status mengembalikan `incomplete` saat wizard verifikasi sedang berlangsung. Setelah wizard selesai, API mengembalikan `verified`.
Dibatalkan	`Partner.Canceled.NZDL`	Untuk contoh ini, permintaan segera dibatalkan. API status mengembalikan `canceled`, dan SEEK Pass mengirimkan event webhook yang dibatalkan.

Permintaan berikut menggunakan nilai NZDL yang telah diverifikasi sebagai contoh:

# POST /api/partner/v2/verify/requests/digital_identity.json
{
  "display_options": {
    "partner_name": "Partner.Verified.NZDL"
  }
}

Untuk hasil yang telah diverifikasi, buka redirect_uri yang dikembalikan dalam respons dan selesaikan wizard. Kemudian gunakan ID permintaan untuk memeriksa hasilnya:

GET /api/partner/v2/verify/requests/{id}

SEEK Pass juga mengirimkan event webhook ketika hasil tes sudah siap. Untuk informasi lebih lanjut, lihat Hasil verifikasi melalui Webhook.

Sebelumnya: Alur Integrasi

Berikutnya: Webhook