Crear Payment Intent

POST

/api/developer/payment-intents

Descripción
Crea un Payment Intent, que representa una intención de cobro por un monto específico.
El sistema genera una referencia única que el usuario puede usar para pagar (SPEI).

¿Para qué sirve?

Cobros controlados

Pagos únicos o parciales

Financiamientos

Pagos semanales

Referencias de pago automatizadas

Funcionamiento
Se define:

Monto esperado

Descripción del cobro

El sistema genera:

reference (ej. pi_xxxxx)

Estatus inicial pending

Los pagos recibidos con esa referencia:

Se aplican automáticamente

Actualizan el estado del intent

Resultado esperado

Payment Intent listo para recibir pagos

Puede liquidarse total o parcialmente

Solicitud

Autorización

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200Éxito

application/json

Body

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://stp.paydaymx.com/api/developer/payment-intents' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 100.50,
    "description": "Pago de servicio"
}'

Ejemplo de Respuesta

{
    "paymentIntent": {
        "tenantId": "09aa19ee-3dd7-45c2-a7ef-ee01aed98182",
        "reference": "pi_b232db628b30ecef7cd2",
        "amount": 100.5,
        "amountReceived": 0,
        "status": "pending",
        "description": "Pago de servicio",
        "createdBy": "apiKey:696e92545278d77847c8be94",
        "lastPaidAt": null,
        "completedAt": null,
        "_id": "696eb034077d200806135153",
        "payments": [],
        "createdAt": "2026-01-19T22:29:08.373Z",
        "updatedAt": "2026-01-19T22:29:08.373Z",
        "__v": 0
    }
}

Modificado en 2026-01-20 19:23:27

Listar Transaccion

Listar Payment Intents