Cabut permintaan

Mitra dapat mencabut permintaan yang sedang berlangsung dan terverifikasi menggunakan endpoint pencabutan. Ini membatalkan semua permintaan yang sedang berlangsung, membatalkan kredensial terverifikasi dari paspor pengguna, dan menghapus data terkait. Hingga 50 permintaan dapat dicabut dalam satu panggilan API.

Untuk informasi terperinci tentang persyaratan autentikasi dan spesifikasi API, lihat spesifikasi OpenAPI V2.

Permintaan

Otentikasi memerlukan token JWT dengan revoke.credential cakupan OAuth.

curl -X POST -L $SEEK_PASS_URL/api/partner/v2/add/requests/revoke.json \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
    "requests": [
        {
            "request_id": "f25c6425-eed4-4853-95bc-fb19aacd4e1e",
            "reason": "information_discrepancy"
        }
    ]
}'

request_id adalah nilai yang sama yang diberikan sebagai credential_id saat permintaan dibuat melalui Endpoint tambah mitra.

Alasan pencabutan

Setiap permintaan harus mencantumkan alasan dengan salah satu nilai berikut:

information_discrepancy — data kredensial tidak benar. Kandidat mungkin menerima notifikasi email.
user_initiated — kandidat meminta penghapusan. Kandidat mungkin menerima notifikasi email.
suspicious_activity — kredensial sedang dicabut karena aktivitas mencurigakan. Tidak ada notifikasi email yang dikirim.

Kode respons

204 No Content: Permintaan berhasil dicabutPencabutan diterima. Tidak ada body respons yang dikembalikan. Jika permintaan sudah dicabut, endpoint tetap mengembalikan 204.

Sebelumnya: Periksa status pengajuan

Berikutnya: Alur Integrasi