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 otentikasi dan spesifikasi API, lihat Spesifikasi OpenAPI V2.

Permintaan

Autentikasi memerlukan token JWT dengan cakupan OAuth revoke.credential.

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 Partner Add.

Alasan pencabutan

Setiap permintaan harus mencantumkan alasan dengan salah satu nilai berikut:

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

Kode respons

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

Sebelumnya: Periksa status pengajuan

Berikutnya: Alur Integrasi