Create guided payment intent
Entorno sandbox
https://sandbox.cryptopocket.io/api
Entorno sandbox
https://sandbox.cryptopocket.io/api
POST
/createGuidedPayment
What the user does on the gateway page
1.
2.
card, psd2, or transfer3.
4.
5.
6.
Errors
error / message | HTTP | Description |
|---|---|---|
authorization_incorrect | 200 | Invalid, expired, or non-whitelisted token |
fail_mandatory_field | 200 | Missing user_id |
user_not_found | 200 | user_id does not exist |
user_banned | 200 | User is banned |
require_kyc | 200 | KYC required. data contains the verification URL |
kyc_reinforced_required | 200 | Failed to create payment, you need complete the onboarding_link to increase your operational amount limits |
guided_payment_eur_only | 200 | Non-EUR fiat is not supported for guided payments |
limit_exceded | 200 | Quarterly card purchase limit exceeded |
coin_not_supported | 200 | coin_symbol + coin_chain pair is not active |
min_purchase | 200 | Amount below project minimum. message includes the minimum |
| (exception message) | 200 | Unhandled internal error |
Solicitud
Parámetros de Header
Parámetros del Body application/json
Respuestas
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://sandbox.cryptopocket.io/api/createGuidedPayment' \
--header 'auth;' \
--header 'Content-Type: application/json' \
--data '{
"user_id": 106,
"external_id": "23232323231",
"fiat_symbol": "EUR",
"fiat_amount": 240,
"coin_symbol": "USDC",
"coin_chain": "polygon"
}'Respuesta Ejemplo de Respuesta
{
"status": "success",
"message": "guided_payment_created",
"data": {
"payment_id": "aBcDeFgHiJkLmNoPqRsTuVwXy",
"gateway_url": "https://b2b.cryptopocket.io/payment/aBcDeFgHiJkLmNoPqRsTuVwXy",
"external_id": "order-abc-001"
}
}Modificado en 2026-06-29 08:26:34