Periksa status pengajuan

Integrasi baru harus menargetkan API versi 2. Silakan lihat Spesifikasi OpenAPI V2.

Anda dapat memeriksa detail dari satu atau beberapa pengajuan, seperti status dan redirect URI, menggunakan endpoint API status. Ini memungkinkan Anda melacak apakah suatu permintaan telah diverifikasi, dibatalkan, atau masih sedang berlangsung, serta mengambil redirect URI untuk mengarahkan pengguna kembali ke SEEK Pass jika mereka tidak melanjutkan pengajuan mereka.

Status

Status	Deskripsi
`incomplete`	Pengajuan sedang berlangsung. Kandidat masih dapat menyelesaikan pengajuan kredensial.
`canceled`	Pengajuan tidak lagi dilanjutkan dan tidak ada kredensial yang diberikan.
`verified`	Pengajuan berhasil diselesaikan dan kredensial telah diberikan.

Untuk informasi terperinci tentang persyaratan otentikasi dan spesifikasi API, lihat Spesifikasi OpenAPI V1.

Pengajuan tunggal

Permintaan

curl -L $SEEK_PASS_URL/api/partner/v1/submissions/$ID/status.json \
-H "Authorization: Bearer $ACCESS_TOKEN"

ID adalah nilai yang diberikan ke kolom id dalam body permintaan untuk endpoint Partner Add (/api/partner/v1/add/$CREDENTIAL_TYPE.json):

Kode respons

200 OK: Status pengajuan ditemukanContoh respons saat pengajuan diverifikasi:

{
    "id": "f25c6425-eed4-4853-95bc-fb19aacd4e1e",
    "status": "verified",
    "finalized_at": "2026-01-01T12:00:00Z",
    "redirect_uri": "https://app.seekpass-staging.com/partner/add/..."
}

Contoh respons saat pengajuan dibatalkan (pengguna membatalkan kredensial):

{
    "id": "b10a30c1-1109-417a-83d3-9d06185ddd0e",
    "status": "canceled",
    "finalized_at": "2026-01-01T12:00:00Z",
    "redirect_uri": "https://app.seekpass-staging.com/partner/add/..."
}

Contoh respons saat pengajuan sedang berlangsung (pengguna belum menyelesaikan alurnya):

{
    "id": "3e8f0108-6b86-4c96-b197-aeec85aff942",
    "status": "incomplete",
    "finalized_at": null,
    "redirect_uri": "https://app.seekpass-staging.com/partner/add/..."
}

Beberapa pengajuan

Permintaan

Hingga 30 status pengajuan dapat diambil. Jika ada ID yang dikirim tidak ditemukan, tidak ada status error yang dikembalikan, tetapi tidak akan ada apa pun dalam data respons untuk ID tersebut.

curl -X POST -L $SEEK_PASS_URL/api/partner/v1/submissions/status.json \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-d '{"ids":["f25c6425-eed4-4853-95bc-fb19aacd4e1e","b10a30c1-1109-417a-83d3-9d06185ddd0e"]}'

Kode respons

200 OKContoh respons:

{
    "credentials": [
      { "id": "f25c6425-eed4-4853-95bc-fb19aacd4e1e", "status": "verified", "finalized_at": "2026-01-01T12:00:00Z", "redirect_uri": "https://app.seekpass-staging.com/partner/add/..." },
      { "id": "b10a30c1-1109-417a-83d3-9d06185ddd0e", "status": "incomplete", "finalized_at": null, "redirect_uri": "https://app.seekpass-staging.com/partner/add/..." }
    ]
}

API Status Massal (V2)

API status massal tersedia untuk memeriksa status beberapa kredensial Tambah ke SEEK Pass 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/add/requests?credential_id[]=25055614-f707-47cc-b7ed-1724c04dcd05&credential_id[]=9a98ba28-cd63-43d4-9959-9c593700c7da
{
    "credentials": [
        {
            "credential_id": "9a98ba28-cd63-43d4-9959-9c593700c7da",
            "created_at": "2026-01-20T02:43:09.440220Z",
            "results": [
                {
                    "credential_type": "digital_identity",
                    "status": "incomplete"
                }
            ]
        },
        {
            "credential_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"
                    }
                }
            ]
        }
    ]
}

Sebelumnya: Alihkan pengguna

Berikutnya: Cabut permintaan