curl -X POST 'https://api.yativo.com/api/v1/card-checkout/account/request-access' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Idempotency-Key: 7b0f3c52-1e4d-4f7a-9a51-2f6c8d0e4b13' \
-H 'Content-Type: application/json' \
-d '{ "note": "We sell online courses to customers in the US and EU." }'
{
"status": "success",
"status_code": 200,
"message": "Card checkout is already enabled",
"data": {
"enabled": true,
"access_status": "requested",
"currencies": [
"USD"
],
"payment_methods": [
"card",
"apple_pay",
"google_pay"
],
"pricing": {
"fee_percent": 3.5,
"fee_fixed": "0.30",
"reserve_percent": 0,
"clearing_business_days": 3,
"retention_days": 0,
"settlement_delay_days": 3
},
"balance": {
"currency": "USD",
"available": "120.50",
"on_hold": "35.00",
"total": "155.50"
},
"balance_by_customer": [
{
"currency": "USD",
"available": "120.50",
"on_hold": "35.00",
"total": "155.50",
"customer_id": "4f0c1e1a-8d2b-4c7e-9b1a-3e5f6a7b8c9d"
}
]
}
}{
"status": "success",
"status_code": 202,
"message": "Access requested",
"data": {
"enabled": true,
"access_status": "requested",
"currencies": [
"USD"
],
"payment_methods": [
"card",
"apple_pay",
"google_pay"
],
"pricing": {
"fee_percent": 3.5,
"fee_fixed": "0.30",
"reserve_percent": 0,
"clearing_business_days": 3,
"retention_days": 0,
"settlement_delay_days": 3
},
"balance": {
"currency": "USD",
"available": "120.50",
"on_hold": "35.00",
"total": "155.50"
},
"balance_by_customer": [
{
"currency": "USD",
"available": "120.50",
"on_hold": "35.00",
"total": "155.50",
"customer_id": "4f0c1e1a-8d2b-4c7e-9b1a-3e5f6a7b8c9d"
}
]
}
}Account
Request access
Ask for Card Checkout to be enabled on your account
POST
/
card-checkout
/
account
/
request-access
curl -X POST 'https://api.yativo.com/api/v1/card-checkout/account/request-access' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Idempotency-Key: 7b0f3c52-1e4d-4f7a-9a51-2f6c8d0e4b13' \
-H 'Content-Type: application/json' \
-d '{ "note": "We sell online courses to customers in the US and EU." }'
{
"status": "success",
"status_code": 200,
"message": "Card checkout is already enabled",
"data": {
"enabled": true,
"access_status": "requested",
"currencies": [
"USD"
],
"payment_methods": [
"card",
"apple_pay",
"google_pay"
],
"pricing": {
"fee_percent": 3.5,
"fee_fixed": "0.30",
"reserve_percent": 0,
"clearing_business_days": 3,
"retention_days": 0,
"settlement_delay_days": 3
},
"balance": {
"currency": "USD",
"available": "120.50",
"on_hold": "35.00",
"total": "155.50"
},
"balance_by_customer": [
{
"currency": "USD",
"available": "120.50",
"on_hold": "35.00",
"total": "155.50",
"customer_id": "4f0c1e1a-8d2b-4c7e-9b1a-3e5f6a7b8c9d"
}
]
}
}{
"status": "success",
"status_code": 202,
"message": "Access requested",
"data": {
"enabled": true,
"access_status": "requested",
"currencies": [
"USD"
],
"payment_methods": [
"card",
"apple_pay",
"google_pay"
],
"pricing": {
"fee_percent": 3.5,
"fee_fixed": "0.30",
"reserve_percent": 0,
"clearing_business_days": 3,
"retention_days": 0,
"settlement_delay_days": 3
},
"balance": {
"currency": "USD",
"available": "120.50",
"on_hold": "35.00",
"total": "155.50"
},
"balance_by_customer": [
{
"currency": "USD",
"available": "120.50",
"on_hold": "35.00",
"total": "155.50",
"customer_id": "4f0c1e1a-8d2b-4c7e-9b1a-3e5f6a7b8c9d"
}
]
}
}Until access is approved, every other Card Checkout endpoint returns
403 with code: card_checkout_not_enabled.
POST https://api.yativo.com/api/v1/card-checkout/account/request-access
note is optional (up to 1,000 characters): tell us what your customers sell and to whom. Sending the request again while it is open changes nothing.
See Card Checkout.
curl -X POST 'https://api.yativo.com/api/v1/card-checkout/account/request-access' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Idempotency-Key: 7b0f3c52-1e4d-4f7a-9a51-2f6c8d0e4b13' \
-H 'Content-Type: application/json' \
-d '{ "note": "We sell online courses to customers in the US and EU." }'
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Headers
A unique string per request to ensure idempotent processing.
Body
application/json
Maximum string length:
1000Example:
"We sell online courses to customers in the US and EU."