Saltar al contenido principal
POST
curl

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Cuerpo

application/json
amount_in_dollars
number
requerido

Importe que se cobrará, en USD. Debe estar entre 50 y 10,000. El saldo recibe el mismo importe, sin descuento ni bonificación. Los impuestos se añaden automáticamente al pagar según la dirección de facturación del cliente.

Rango requerido: 50 <= x <= 10000
success_url
string<uri>

URL a la que el checkout alojado redirige al cliente tras un pago correcto. Actualmente, el valor predeterminado es https://console.didit.me. Indica explícitamente una URL que funcione: el host predeterminado no está disponible. Añade el marcador literal {CHECKOUT_SESSION_ID} si quieres que el checkout alojado lo sustituya por el ID de sesión.

cancel_url
string<uri>

URL a la que el checkout alojado redirige al cliente cuando cancela o cierra la ventana de Checkout. Actualmente, el valor predeterminado es https://console.didit.me. Indica explícitamente una URL que funcione: el host predeterminado no está disponible.

Respuesta

Se creó la sesión de pago alojada. Redirige al usuario a checkout_session_url para completar el pago.

checkout_session_id
string
requerido

Identificador de la sesión de pago alojada (p. ej., cs_test_a1B2c3...). Útil para la conciliación del lado del servidor.

checkout_session_url
string<uri>
requerido

URL de la página de pago alojada de un solo uso. Redirige al cliente aquí para completar el pago.

Última modificación el 1 de noviembre de 2026