> ## Documentation Index > Fetch the complete documentation index at: https://docs.palomma.com/llms.txt > Use this file to discover all available pages before exploring further. # Create invoice > Creates a new invoice for the authenticated merchant. ## OpenAPI ````yaml /openapi.yaml post /invoices openapi: 3.0.3 info: title: Palomma Rentals API version: 1.0.0 description: API for creating and managing rental invoices and settlements. contact: name: Palomma servers: - url: https://api.palomma.com/v1 description: Production - url: https://sandbox.api.palomma.com/v1 description: Sandbox security: - bearerAuth: [] tags: - name: Invoices description: Create, retrieve, and list invoices. - name: Settlements description: Retrieve settlements by date and cycle. paths: /invoices: post: tags: - Invoices summary: Create invoice description: Creates a new invoice for the authenticated merchant. operationId: createInvoice requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateInvoiceRequest' examples: createInvoice: summary: Minimum valid payload value: reference: INV-2026-0001 amount: 1850000 description: Canon de arrendamiento marzo 2026 redirectUrl: https://merchant.example.com/payments/return customerDocumentNumber: '900123456' responses: '200': description: Created invoice content: application/json: schema: $ref: '#/components/schemas/Invoice' examples: created: value: id: 01HQY8EW1H9YGH5PAV5Y2M9R3T reference: INV-2026-0001 status: ready amount: 1850000 description: Canon de arrendamiento marzo 2026 contract: '00000' expirationDate: '2026-03-11T16:37:14.007Z' customerDocumentNumber: '900123456' customerName: Inmobiliaria Ejemplo SAS createdAt: '2026-03-11T16:32:14.007Z' paymentUrl: >- https://pagos.palomma.com/pay/merchant_123/01HQY8EW1H9YGH5PAV5Y2M9R3T '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CreateInvoiceRequest: type: object required: - reference - amount - description - redirectUrl - customerDocumentNumber properties: reference: type: string minLength: 1 description: Unique invoice reference for your records (e.g. `"INV-2026-0001"`). amount: type: integer minimum: 3000 maximum: 550000000 description: Invoice amount in COP. Must be between 3,000 and 550,000,000. description: type: string minLength: 1 description: Invoice description shown to the customer. redirectUrl: type: string format: uri description: >- URL where the customer is redirected after completing the payment flow. customerDocumentNumber: type: string minLength: 1 description: Customer's document or identification number. documentType: type: string description: >- Customer's document type. One of: `cc` (cedula), `ce` (cedula de extranjeria), `nit` (NIT), `ti` (tarjeta de identidad), `ps` (pasaporte), `cif` (codigo de identificacion fiscal), `ne` (NIT extranjero), `rc` (registro civil), `ppt` (permiso de permanencia temporal). enum: - cc - ce - nit - ti - ps - cif - ne - rc - ppt customerName: type: string description: Customer's display name (optional). contract: type: string description: Contract identifier. Defaults to `"00000"` if not provided. default: '00000' Invoice: type: object required: - id - status - amount - description - contract - customerDocumentNumber - createdAt - paymentUrl properties: id: type: string description: Unique invoice identifier. reference: type: string description: Merchant-provided invoice reference. status: type: string description: >- Invoice status: `ready` (payment link active), `paid`, `cancelled`, or `chargeback`. enum: - ready - paid - cancelled - chargeback amount: type: number description: Invoice amount in COP. description: type: string description: Invoice description. contract: type: string description: Contract identifier. expirationDate: type: string description: >- Payment link expiration datetime (ISO 8601). Invoices expire 5 minutes after creation, so redirect the customer immediately. Once a transaction is in progress, it no longer expires until the transaction completes. customerDocumentNumber: type: string description: Customer's document number. customerName: type: string description: Customer's display name. createdAt: type: string description: Invoice creation datetime (ISO 8601). paymentDate: type: string format: date-time description: When the invoice was paid. Present on paid and chargeback invoices. paymentMethod: type: string enum: - pse - nequiButton - bancolombiaButton - breb - card description: Payment method used. Present on paid and chargeback invoices. paymentSource: type: string enum: - whatsapp - portal - link description: >- Channel through which payment was made. Present on paid and chargeback invoices. paymentAmount: type: number description: >- Amount actually paid in COP. Present on paid and chargeback invoices. settlementDate: type: string description: >- Expected settlement date (`YYYY-MM-DD`). Present on paid and chargeback invoices. settlementTime: type: string description: Expected settlement cycle. Present on paid and chargeback invoices. paymentId: type: string description: Payment identifier. Present on paid and chargeback invoices. paymentUrl: type: string format: uri description: Palomma hosted payment page URL for this invoice. ErrorResponse: type: object required: - error properties: error: type: string description: Human-readable error message. responses: BadRequest: description: Invalid request input content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalidBody: value: error: Invalid JSON in request body schemaError: value: error: Amount must be an integer Unauthorized: description: Invalid or missing bearer token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Invalid or missing token InternalServerError: description: Unexpected server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Internal Server Error securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: 'Send header: `Authorization: Bearer `.' ````