Publish Checkout Configuration - Yuno API Documentation

PATCH

/

v1

/

checkouts

/

{checkout_code}

/

publish

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"
    }
  ]
}
'

{
  "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

code

string

Checkout UUID.

Example:

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

updated_at

string

Timestamp of the update.

Example:

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

Get Required FieldsReturns the set of configurable required fields for a given payment method and flow type. Use this before building a required_fields_to_override payload to ensure you reference valid field names.

⌘I

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"
    }
  ]
}
'

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