Recover Declined Payments

Triggers automated outreach (AI caller) to recover declined payments by contacting the customer to update their payment method or resolve the issue.

POST /v1/smart-support/external/payments/recover

Recover declined payments

cURL

curl --request POST \
  --url https://api-sandbox.y.uno/v1/smart-support/external/payments/recover \
  --header 'Content-Type: application/json' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "payment_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "channel": "PHONE",
  "language": "pt-BR"
}
'

202

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "channel": "<string>",
  "created_at": "2023-11-07T05:31:56Z"
}

Beta Feature. Smart Support (AI Caller) is currently in beta. Availability: Brazil and Mexico (Spanish and Portuguese). Contact your Yuno account manager for pricing and to enable this feature. Automated outbound calls require explicit customer consent under LGPD (Brazil) and LFPDPPP (Mexico) regulations.

Authorizations

public-api-key · string · header · required

Your public API key from the Yuno Dashboard

private-secret-key · string · header · required

Your private secret key (server-side only)

Body

application/json

payment_id · string<uuid> · required

The declined payment to recover

channel · enum<string>

Outreach channel

Available options: PHONE, SMS, EMAIL, WHATSAPP

language · string

Language code (e.g., pt-BR, es-MX)

Example:

"pt-BR"

Response

202

application/json

Recovery process initiated

id · string<uuid>

status · enum<string>

Available options: QUEUED, IN_PROGRESS, COMPLETED, FAILED

channel · string

created_at · string<date-time>