curl --request POST \
--url https://api.quentli.com/v1/payment-sessions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {
"customer": {
"name": "Juan Pérez",
"externalId": "A-1029",
"phoneNumber": "+5215512345678",
"email": "juan@example.com",
"forceUpdate": false,
"metadata": []
},
"returnUrl": "https://example.com/success",
"cancelUrl": "https://example.com/cancel",
"displayMode": "CUSTOMER_PORTAL",
"expiresAt": "2023-11-07T05:31:56Z",
"description": "Colegiatura Enero 2025",
"amount": 150000,
"currency": "MXN",
"items": [],
"metadata": []
}
}
'{
"url": "<string>",
"paymentSession": {
"id": "ps_1234567890abcdefghij",
"createdAt": "2025-01-15T18:00:00.000Z",
"updatedAt": "2025-01-15T18:00:00.000Z",
"status": "PENDING",
"displayMode": "CUSTOMER_PORTAL",
"origin": "API",
"expiresAt": null,
"totalAmount": 150000,
"currency": "MXN",
"returnUrl": null,
"cancelUrl": null,
"organizationId": "org_1234567890abcdefghij",
"items": [
{
"description": "Colegiatura Enero 2025",
"amount": 150000,
"quantity": 1,
"currency": "MXN"
}
],
"customer": {
"id": "cus_1234567890abcdefghij",
"createdAt": "2025-01-10T12:00:00.000Z",
"updatedAt": "2025-01-10T12:00:00.000Z",
"name": "Juan Pérez",
"username": "juan_perez_01",
"organizationId": "org_1234567890abcdefghij",
"acceptedServiceAgreement": true,
"skipTaxInvoice": false,
"emailVerified": false,
"phoneNumberVerified": true,
"hasChangedPassword": true,
"email": "juan@example.com",
"phoneNumber": "+525512345678",
"secondaryPhoneNumber": null,
"archivedAt": null,
"archivedById": "u_1234567890abcdefghij",
"signatureAcceptedAt": "2025-01-10T12:00:00.000Z",
"optedOutWhatsappAt": null,
"optedInWhatsappAt": "2025-01-05T10:00:00.000Z",
"startedWhatsappAt": "2025-01-05T09:55:00.000Z",
"replyWithAssistant": false,
"metadata": [
{
"key": "studentId",
"value": "A-1029"
}
],
"meta": {
"studentId": "A-1029"
}
},
"metadata": [
{
"key": "<string>",
"value": "<string>"
}
]
},
"session": {
"accessToken": "<string>",
"csrfToken": "<string>",
"refreshToken": "<string>",
"accessTokenExpiresAt": "2023-11-07T05:31:56Z",
"expiresAt": "2023-11-07T05:31:56Z"
}
}Creates a hosted payment session. Resolves or creates the customer and returns an authenticated payment URL.
curl --request POST \
--url https://api.quentli.com/v1/payment-sessions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {
"customer": {
"name": "Juan Pérez",
"externalId": "A-1029",
"phoneNumber": "+5215512345678",
"email": "juan@example.com",
"forceUpdate": false,
"metadata": []
},
"returnUrl": "https://example.com/success",
"cancelUrl": "https://example.com/cancel",
"displayMode": "CUSTOMER_PORTAL",
"expiresAt": "2023-11-07T05:31:56Z",
"description": "Colegiatura Enero 2025",
"amount": 150000,
"currency": "MXN",
"items": [],
"metadata": []
}
}
'{
"url": "<string>",
"paymentSession": {
"id": "ps_1234567890abcdefghij",
"createdAt": "2025-01-15T18:00:00.000Z",
"updatedAt": "2025-01-15T18:00:00.000Z",
"status": "PENDING",
"displayMode": "CUSTOMER_PORTAL",
"origin": "API",
"expiresAt": null,
"totalAmount": 150000,
"currency": "MXN",
"returnUrl": null,
"cancelUrl": null,
"organizationId": "org_1234567890abcdefghij",
"items": [
{
"description": "Colegiatura Enero 2025",
"amount": 150000,
"quantity": 1,
"currency": "MXN"
}
],
"customer": {
"id": "cus_1234567890abcdefghij",
"createdAt": "2025-01-10T12:00:00.000Z",
"updatedAt": "2025-01-10T12:00:00.000Z",
"name": "Juan Pérez",
"username": "juan_perez_01",
"organizationId": "org_1234567890abcdefghij",
"acceptedServiceAgreement": true,
"skipTaxInvoice": false,
"emailVerified": false,
"phoneNumberVerified": true,
"hasChangedPassword": true,
"email": "juan@example.com",
"phoneNumber": "+525512345678",
"secondaryPhoneNumber": null,
"archivedAt": null,
"archivedById": "u_1234567890abcdefghij",
"signatureAcceptedAt": "2025-01-10T12:00:00.000Z",
"optedOutWhatsappAt": null,
"optedInWhatsappAt": "2025-01-05T10:00:00.000Z",
"startedWhatsappAt": "2025-01-05T09:55:00.000Z",
"replyWithAssistant": false,
"metadata": [
{
"key": "studentId",
"value": "A-1029"
}
],
"meta": {
"studentId": "A-1029"
}
},
"metadata": [
{
"key": "<string>",
"value": "<string>"
}
]
},
"session": {
"accessToken": "<string>",
"csrfToken": "<string>",
"refreshToken": "<string>",
"accessTokenExpiresAt": "2023-11-07T05:31:56Z",
"expiresAt": "2023-11-07T05:31:56Z"
}
}Organization API key using Authorization: Bearer sk_....
Request body for creating a payment session.
Show child attributes
Payment session created
Was this page helpful?