curl 'https://api.yativo.com/api/v1/card-checkout/account' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"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": "failed",
"status_code": 403,
"message": "<string>",
"data": {
"error": "Card checkout is not enabled for your account. Contact support to request access.",
"code": "card_checkout_not_enabled"
},
"error": {
"code": "invalid_argument",
"message": "<string>",
"request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
},
"error_details": {
"code": "validation_error",
"message": "The amount field is required.",
"http_status": 422,
"fields": {},
"retryable": false,
"retry_after": 123
}
}Account
Get account
Read your Card Checkout access, pricing, payment methods and balance
GET
/
card-checkout
/
account
curl 'https://api.yativo.com/api/v1/card-checkout/account' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"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": "failed",
"status_code": 403,
"message": "<string>",
"data": {
"error": "Card checkout is not enabled for your account. Contact support to request access.",
"code": "card_checkout_not_enabled"
},
"error": {
"code": "invalid_argument",
"message": "<string>",
"request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
},
"error_details": {
"code": "validation_error",
"message": "The amount field is required.",
"http_status": 422,
"fields": {},
"retryable": false,
"retry_after": 123
}
}Returns
See Your account and balance.
enabled, access_status, currencies, payment_methods, pricing, balance and balance_by_customer.
GET https://api.yativo.com/api/v1/card-checkout/account
curl 'https://api.yativo.com/api/v1/card-checkout/account' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
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.

