Beneficiaries
Send the verification link
Emails the beneficiary a new identity verification link, required before their EUR / USD bank accounts can be paid.
Use it when they lost the email, or to start verification for a beneficiary saved before it existed.
Errors: no_verified_account, email_required, country_not_supported, email_used_by_other_entity_type, verification_request_rejected (422); already_verified, resend_too_soon (less than 10 minutes since the last link), verification_unavailable (409); verification_provider_error (502).
API key scope: payouts:write
POST
/
v1
/
counterparties
/
{id}
/
verification
Send the verification link
curl --request POST \
--url https://staging.api.krypta-pay.com/v1/counterparties/{id}/verification \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://staging.api.krypta-pay.com/v1/counterparties/{id}/verification', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://staging.api.krypta-pay.com/v1/counterparties/{id}/verification"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://staging.api.krypta-pay.com/v1/counterparties/{id}/verification",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"ok": true,
"data": {
"id": "cmh1a2b3c0001xyz",
"entityType": "INDIVIDUAL",
"fullName": "Jean Dupont",
"type": "FOURNISSEUR",
"country": "FR",
"email": "jean.dupont@example.com",
"approvalStatus": "PENDING",
"rejectionReason": null,
"isBlacklisted": false,
"verificationRequiredAt": "2026-11-11T10:15:00.000Z",
"verification": {
"status": "NOT_STARTED",
"tosAccepted": false,
"nameMismatch": false,
"lastSentAt": "2026-11-11T10:15:00.000Z",
"rejectionReasons": []
},
"accounts": [
{
"id": "cmh1a2b3c0002xyz",
"kind": "BANK",
"currency": "EUR",
"label": null,
"bankName": "BNP Paribas",
"accountHolder": "Jean Dupont",
"iban": "FR7630006000011234567890189",
"swiftBic": "BNPAFRPP"
}
]
}
}{
"ok": false,
"error": {
"code": "unauthorized",
"message": "Invalid or expired API key"
}
}{
"ok": false,
"error": {
"code": "kyb_required",
"message": "Your organization must complete KYB verification."
}
}{
"ok": false,
"error": {
"code": "not_found",
"message": "Payout not found"
}
}{
"ok": false,
"error": {
"code": "bad_status",
"message": "Cannot cancel in status PROCESSING"
}
}{
"ok": false,
"error": {
"code": "validation_error",
"message": "amount: Invalid amount"
}
}{
"ok": false,
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded, retry in 1 minute"
}
}{
"ok": false,
"error": {
"code": "payin_unavailable",
"message": "Le paiement Mobile Money est momentanément indisponible."
}
}Authorizations
Secret API key from Dashboard → Developers: kp_sandbox_… for Sandbox, kp_live_… for Production. Server-side only.
Path Parameters
Beneficiary id.
⌘I
Send the verification link
curl --request POST \
--url https://staging.api.krypta-pay.com/v1/counterparties/{id}/verification \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://staging.api.krypta-pay.com/v1/counterparties/{id}/verification', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://staging.api.krypta-pay.com/v1/counterparties/{id}/verification"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://staging.api.krypta-pay.com/v1/counterparties/{id}/verification",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"ok": true,
"data": {
"id": "cmh1a2b3c0001xyz",
"entityType": "INDIVIDUAL",
"fullName": "Jean Dupont",
"type": "FOURNISSEUR",
"country": "FR",
"email": "jean.dupont@example.com",
"approvalStatus": "PENDING",
"rejectionReason": null,
"isBlacklisted": false,
"verificationRequiredAt": "2026-11-11T10:15:00.000Z",
"verification": {
"status": "NOT_STARTED",
"tosAccepted": false,
"nameMismatch": false,
"lastSentAt": "2026-11-11T10:15:00.000Z",
"rejectionReasons": []
},
"accounts": [
{
"id": "cmh1a2b3c0002xyz",
"kind": "BANK",
"currency": "EUR",
"label": null,
"bankName": "BNP Paribas",
"accountHolder": "Jean Dupont",
"iban": "FR7630006000011234567890189",
"swiftBic": "BNPAFRPP"
}
]
}
}{
"ok": false,
"error": {
"code": "unauthorized",
"message": "Invalid or expired API key"
}
}{
"ok": false,
"error": {
"code": "kyb_required",
"message": "Your organization must complete KYB verification."
}
}{
"ok": false,
"error": {
"code": "not_found",
"message": "Payout not found"
}
}{
"ok": false,
"error": {
"code": "bad_status",
"message": "Cannot cancel in status PROCESSING"
}
}{
"ok": false,
"error": {
"code": "validation_error",
"message": "amount: Invalid amount"
}
}{
"ok": false,
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded, retry in 1 minute"
}
}{
"ok": false,
"error": {
"code": "payin_unavailable",
"message": "Le paiement Mobile Money est momentanément indisponible."
}
}