This service allows merchants to cancel previously generated valid tokens.

Example request

URL Selector with Opacity

Post

Production URL Sandbox URL

curl -X POST \
   -H 'X-Date: {X-Date}' \
   -H 'X-Login: {X-Login}' \
   -H 'X-Trans-Key: {X-Trans-Key}' \
   -H 'Content-Type: application/json' \
   -H 'X-Version: 2.1' \
   -H 'User-Agent: MerchantTest / 1.0 ' \
   -H 'Authorization: V2-HMAC-SHA256, Signature: {Signature}' \
   https://api.dlocal.com/payments/wallet/979d887a-2c63-4719-ba65-0b20b50f1cab/cancel

{
  "wallet": {
    "token": "979d887a-2c63-4719-ba65-0b20b50f1cab"
  },
  "status": "CANCELLED",
  "status_detail": "The wallet token was cancelled",
  "status_code": "400"
}

Receive user token cancellation

Users can cancel consent within their home banking or on the dLocal portal. When this occurs, dLocal will notify the merchant that the user has canceled their token.

Asynchronous Notification (webhook)

{
  "wallet": {
    "token": "979d887a-2c63-4719-ba65-0b20b50f1cab",
  }, 
  "status": "CANCELLED",
  "status_detail": "Wallet token cancelled by user",
  "status_code": "401"
}