Skip to main content
POST
/
smart-support
/
external
/
payments
/
recover
Copy of Declined Payment Calls
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 '
{
  "settings": {
    "contact_details": {
      "channel": "PHONE_CALL",
      "initial_template_message": {
        "id": "HX8e7ac569f40a064c71a37e5d672bb9123",
        "variables": {
          "name": "Maria",
          "amount": "$10.0000"
        }
      },
      "pdf_template": {
        "id": "ede0d2da-138d-441b-8101-85e2d21af8b9",
        "variables": {
          "seller_name": "RAPPI",
          "merchant_order_id": "MX_Verification_50708779"
        }
      },
      "payment_methods": {
        "available": [
          "MERCADO_PAGO",
          "NEQUI"
        ]
      }
    }
  },
  "additional_information": {
    "seller_details": {
      "name": "RAPPI",
      "fallback_instructions": "Go to the application and click on the top right corner to contact a customer support agent.",
      "redirection_url": "www.test.com/purchase"
    },
    "payment": {
      "account_id": "e4c03f29-b0f6-403a-8814-9aee1a88d60e",
      "id": "f1fbad16-93c1-4335-b735-2b01ec94ea9e",
      "merchant_order_id": "MX_Verification_50708779",
      "country": "CO",
      "description": "Purchase in McDonalds",
      "created_at": "2022-05-09T20:46:54.786342Z",
      "declined_reason": "insufficient funds",
      "payment_method": {
        "type": "Credit Card",
        "detail": {
          "card_data": {
            "iin": "636318",
            "lfd": "2671",
            "type": "CREDIT",
            "issuer": "SCOTIABANK",
            "expiration_year": 2030,
            "expiration_month": 12
          }
        }
      },
      "amount": {
        "currency": "COP",
        "value": 27000
      },
      "customer_payer": {
        "first_name": "Pepito",
        "last_name": "Perez",
        "phone": {
          "country_code": "57",
          "number": "3132450765"
        }
      }
    }
  }
}
'
{
  "id": "7c3a9c6e-9bf0-4c2c-9f67-752b16ba5dd5",
  "message": "Communication processed successfully"
}
This endpoint allows you to initiate large-scale processing of calls and WhatsApp messages related to declined payments. To use the endpoint, you have to provide an object containing detailed information about the declined payment.

Authorizations

public-api-key
string
header
required

Example: <Your public-api-key>

private-secret-key
string
header
required

Example: <Your private-secret-key>

Body

application/json
settings
object
required

AI agent configuration

additional_information
object

All relevant information to feed to the AI to improve context.

Response

Success

id
string
Example:

"7c3a9c6e-9bf0-4c2c-9f67-752b16ba5dd5"

message
string
Example:

"Communication processed successfully"