Skip to main content
POST
/
v1
/
yativo-card
/
customers
/
{yativoCardId}
/
reset
curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a_abc_1769031332068/reset' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "message": "Customer onboarding reset. Re-onboard this customer via POST /api/yativo-card/customers/onboard with a different email address.",
  "data": {
    "deleted_card_id": "yativo_card_customer_8f9a...abc_1769031332068",
    "email_masked": "sa***@hotmail.com",
    "external_customer_id": "usr_8821",
    "next_step": "POST /api/yativo-card/customers/onboard",
    "email_warning": "The email address used previously remains registered with the card network and cannot be reused. Use a different email address when re-onboarding this customer."
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.yativo.com/llms.txt

Use this file to discover all available pages before exploring further.

Deletes the customer’s Yativo record, allowing re-onboarding from scratch with a new verification flow. Use this when a customer is stuck in a state that cannot be recovered — for example, repeated KYC failures or an account that was set up with wrong details.
The email address used previously cannot be reused. It remains registered with the card network. You must re-onboard the customer with a different email address. Attempting to use the same email will return EMAIL_ALREADY_REGISTERED.
Restrictions:
  • Blocked if the customer already has a payment card issued (card_created or active status). Once a card exists, this endpoint returns CARD_ALREADY_ISSUED — contact support for admin-level resets.
  • Only resets customers belonging to your issuer program (account_type: customer).
​
yativoCardId
string
required
The yativo_card_id of the customer to reset.
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a_abc_1769031332068/reset' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "message": "Customer onboarding reset. Re-onboard this customer via POST /api/yativo-card/customers/onboard with a different email address.",
  "data": {
    "deleted_card_id": "yativo_card_customer_8f9a...abc_1769031332068",
    "email_masked": "sa***@hotmail.com",
    "external_customer_id": "usr_8821",
    "next_step": "POST /api/yativo-card/customers/onboard",
    "email_warning": "The email address used previously remains registered with the card network and cannot be reused. Use a different email address when re-onboarding this customer."
  }
}