Skip to main content
POST
/
v1
/
payment-sessions
Create payment session
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"
  }
}

Authorizations

Authorization
string
header
required

Organization API key using Authorization: Bearer sk_....

Body

application/json

Request body for creating a payment session.

input
object
required

Response

Payment session created

Created payment session with an authenticated URL.

url
string
required

Authenticated payment URL for the customer.

paymentSession
object
required

The created payment session.

session
object

Customer session tokens, if a customer was resolved.