Publish Checkout Configuration

Sparse-upsert the checkout’s payment method configuration. Payment methods omitted from the array retain their previous state — they are not removed. To disable a method, include it with is_active: false. Changes take effect immediately on the merchant’s live checkout.

PATCH /v1/checkouts/{checkout_code}/publish

cURL

Disable CARD

curl --request PATCH \
  --url https://api.y.uno/v1/checkouts/{checkout_code}/publish \
  --header 'Content-Type: application/json' \
  --header 'PRIVATE-SECRET-KEY: <api-key>' \
  --header 'PUBLIC-API-KEY: <api-key>' \
  --header 'X-Account-Code: <api-key>' \
  --data '
{
  "payment_methods": [
    {
      "is_active": false,
      "payment_method_type": "NU_PAY_ENROLLMENT",
      "order_to_show": 1,
      "type": "ENROLLMENT"
    },
    {
      "is_active": true,
      "payment_method_type": "PAYPAL_ENROLLMENT",
      "order_to_show": 2,
      "type": "ENROLLMENT"
    },
    {
      "is_active": false,
      "payment_method_type": "CARD",
      "order_to_show": 3,
      "type": "PAYMENT_METHOD",
      "active_enrollment_type": "NONE"
    },
    {
      "is_active": true,
      "payment_method_type": "GOOGLE_PAY",
      "order_to_show": 4,
      "type": "PAYMENT_METHOD"
    },
    {
      "is_active": true,
      "payment_method_type": "APPLE_PAY",
      "order_to_show": 5,
      "type": "PAYMENT_METHOD"
    }
  ]
}
'

200

{
  "code": "8005ca91-dcfb-4428-b9f6-49c6e3446474",
  "updated_at": "2026-05-18T14:00:00Z"
}

This API is in Beta. Endpoints and schemas may change without prior notice.

Authorizations

PUBLIC-API-KEY · string · header · required

Merchant public API key. Found in Yuno dashboard → Settings → API Keys.

PRIVATE-SECRET-KEY · string · header · required

Merchant private secret key, paired with the public key. Never embed in client-side code.

X-Account-Code · string · header · required

UUID of the merchant account scope for the request.

Headers

X-Idempotency-Key · string

Client-generated UUID. Re-sending the same request with the same key is safe and will not double-publish.

Path Parameters

checkout_code · string · required

The UUID of the checkout to update.

Body

application/json

payment_methods · object[] · required

Payment methods to upsert. Only included methods are updated — omitted methods retain their previous state.

Show child attributes

general_settings · object

General checkout settings.

Show child attributes

Response

200

application/json

200

code · string

Checkout UUID.

Example:

"8005ca91-dcfb-4428-b9f6-49c6e3446474"

updated_at · string

Timestamp of the update.

Example:

"2026-05-18T14:00:00Z"