curl -X POST 'https://api.yativo.com/api/v1/card-checkout/customers/4f0c1e1a-8d2b-4c7e-9b1a-3e5f6a7b8c9d/endorsement' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Idempotency-Key: 1a2b3c4d-5e6f-7890-abcd-ef1234567890'
{
"status": "success",
"status_code": 202,
"message": "Endorsement submitted",
"data": {
"customer_id": "4f0c1e1a-8d2b-4c7e-9b1a-3e5f6a7b8c9d",
"customer_type": "individual",
"endorsement_status": "not_started",
"verification_status": "pending",
"can_accept_payments": true,
"onboarding_url": "<string>",
"onboarding_url_expires_at": "2023-11-07T05:31:56Z",
"balance": {
"currency": "USD",
"available": "96.20",
"pending": "0.00",
"reserved": "0.00",
"on_hold": "0.00",
"total": "96.20",
"next_available_at": "2023-11-07T05:31:56Z"
},
"message": "<string>",
"awaiting_business_access": true
}
}{
"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
}
}{
"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
}
}Selling customers
Submit endorsement
Verify a customer so it can sell by card
POST
/
card-checkout
/
customers
/
{customer_id}
/
endorsement
curl -X POST 'https://api.yativo.com/api/v1/card-checkout/customers/4f0c1e1a-8d2b-4c7e-9b1a-3e5f6a7b8c9d/endorsement' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Idempotency-Key: 1a2b3c4d-5e6f-7890-abcd-ef1234567890'
{
"status": "success",
"status_code": 202,
"message": "Endorsement submitted",
"data": {
"customer_id": "4f0c1e1a-8d2b-4c7e-9b1a-3e5f6a7b8c9d",
"customer_type": "individual",
"endorsement_status": "not_started",
"verification_status": "pending",
"can_accept_payments": true,
"onboarding_url": "<string>",
"onboarding_url_expires_at": "2023-11-07T05:31:56Z",
"balance": {
"currency": "USD",
"available": "96.20",
"pending": "0.00",
"reserved": "0.00",
"on_hold": "0.00",
"total": "96.20",
"next_available_at": "2023-11-07T05:31:56Z"
},
"message": "<string>",
"awaiting_business_access": true
}
}{
"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
}
}{
"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
}
}No body. Yativo reuses the customer’s KYC or KYB. Send them to
onboarding_url.
If the customer asks before your account has access, the request is held (202, awaiting_business_access: true) and an access request is filed for you.
You can also submit with POST /customer/kyc/resubmit/{customer_id}/card_checkout.
See Submit the endorsement.
curl -X POST 'https://api.yativo.com/api/v1/card-checkout/customers/4f0c1e1a-8d2b-4c7e-9b1a-3e5f6a7b8c9d/endorsement' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Idempotency-Key: 1a2b3c4d-5e6f-7890-abcd-ef1234567890'
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.