Retry Subscription

POST /subscriptions/{id}/retry

Retry Subscription

cURL

curl --request POST \
  --url https://api-sandbox.y.uno/v1/subscriptions/{id}/retry \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>'

200

{
  "id": "0054840f-bcd5-4d8e-b86c-c18ede81c556",
  "name": "Test Subscription",
  "account_id": "f7c5fe77-721b-49c2-84d3-957748df3c2c",
  "country": "CL",
  "description": "Subscription Test",
  "merchant_reference": "subscription-ref-merchant-AA01",
  "status": "ACTIVE",
  "amount": {
    "currency": "CLP",
    "value": 15000
  },
  "frequency": {
    "type": "MONTH",
    "value": 1
  },
  "billing_cycles": {
    "total": 12,
    "current": 2,
    "next_at": "2025-05-29T11:13:31.786421Z"
  },
  "customer_payer": {
    "id": "1c6d1a88-d8d5-4c09-b19c-852530d89f05"
  },
  "payment_method": {
    "type": "CARD",
    "vaulted_token": "743880c1-1bdb-4572-99a8-c4e5ce184895"
  },
  "availability": {
    "start_at": "2025-04-29T11:13:31.786421Z",
    "finish_at": null
  },
  "retries": {
    "retry_on_decline": false,
    "amount": 6
  },
  "metadata": null,
  "additional_data": null,
  "trial_period": {
    "billing_cycles": 1,
    "amount": {
      "value": 0,
      "currency": ""
    }
  },
  "initial_payment_validation": false,
  "created_at": "2025-04-29T11:13:31.786421Z",
  "updated_at": "2025-04-29T11:13:31.942325Z"
}

Use this endpoint to manually retry the most recent failed payment of a subscription. This is useful when a customer updates their payment method or resolves a payment issue (e.g., insufficient funds, expired card) mid-billing cycle, since subscription updates only take effect starting from the next billing cycle. Calling this endpoint forces a new charge attempt for the current cycle using the latest subscription configuration.

• Only the most recent payment of the subscription can be retried.
• Multiple manual retries can be executed only if the previous retry attempt resulted in a DECLINED status.
• Manually triggering a retry stops the smart retry scheme for the corresponding payment. The following payments of the subscription will follow the smart retry scheme if enabled in the creation.
• After the successful retry attempt, the system continues with the next scheduled subscription charge.
• If neither condition is met, an INVALID_REQUEST error is returned.

Authorizations

public-api-key · string · header · default: <Your public-api-key> · required

private-secret-key · string · header · default: <Your private-secret-key> · required

Headers

x-account-code · string

The account_id found in your Yuno Dashboard (UUID).

Path Parameters

id · string · required

The unique identifier of the subscription, see create subscription (UUID).

Response

200

application/json

200

id · string

Example:

"0054840f-bcd5-4d8e-b86c-c18ede81c556"

name · string

Example:

"Test Subscription"

account_id · string

Example:

"f7c5fe77-721b-49c2-84d3-957748df3c2c"

country · string

Example:

"CL"

description · string

Example:

"Subscription Test"

merchant_reference · string

Example:

"subscription-ref-merchant-AA01"

status · string

Example:

"ACTIVE"

amount · object

Show child attributes

frequency · object

Show child attributes

billing_cycles · object

Show child attributes

customer_payer · object

Show child attributes

payment_method · object

Show child attributes

availability · object

Show child attributes

retries · object

Show child attributes

metadata · any

additional_data · any

trial_period · object

Show child attributes

initial_payment_validation · boolean · default: true

Example:

false

created_at · string

Example:

"2025-04-29T11:13:31.786421Z"

updated_at · string

Example:

"2025-04-29T11:13:31.942325Z"