Skip to main content
POST
/
smart-support
/
external
/
payments
Initiate Recovery Outreach for Abandoned User Flows
curl --request POST \
  --url https://api-sandbox.y.uno/v1/smart-support/external/payments \
  --header 'Content-Type: application/json' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "customer": {
    "full_name": "Robert Johnson",
    "phone_number": "+12125550103",
    "email": "robert.johnson@example.com",
    "country_code": "US",
    "language": "en"
  },
  "session": {
    "abandonment_timestamp": "2025-05-13T22:45:00Z",
    "flow_stage": "cart_review",
    "platform": "ios",
    "session_id": "sess_def456uvw"
  },
  "cart": {
    "total_value": 29.99,
    "currency": "USD",
    "items": [
      {
        "name": "Bluetooth Speaker",
        "sku": "BSPEAKER-PRO",
        "quantity": 1,
        "price": 29.99
      }
    ]
  },
  "engagement": {
    "preferred_channel": "whatsapp",
    "reason": "user_abandoned_cart",
    "metadata": {
      "utm_campaign": "summer_promo",
      "last_clicked_button": "Continue Shopping"
    }
  }
}
'
This endpoint allows merchants to notify Yuno’s Recovery Agent when a user abandons their purchase flow, such as during product selection or after initiating checkout, before completing a payment. The submitted data enables Yuno to follow up with the user via call or WhatsApp to encourage completion of the transaction.

​
Security and compliance

  • Authentication: API access requires a valid API key provided in the request headers.
  • Data Protection: All data must be transmitted over HTTPS. Yuno adheres to relevant data protection regulations, including GDPR and LGPD.
  • Data Usage: Submitted data will be used solely for the purpose of customer engagement and will not be stored beyond the necessary duration.
Use Case ExampleA user named Jane Doe adds a pair of wireless headphones to her cart on a merchant’s website but abandons the checkout process. The merchant’s system detects this and sends the relevant payload to Yuno’s Recovery Agent API. Yuno then initiates a WhatsApp message to Jane, reminding her of the items left in her cart and offering assistance to complete the purchase.

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
​
customer
object
required
​
session
object
required
​
cart
object
​
engagement
object

Response

Successfully initiated recovery outreach.