PApalomma
Invoices

Create invoice

Creates a new invoice for the authenticated merchant.

post/invoices

Request

  • Base URL
    https://api.palomma.com/v1
  • Auth
    HTTP bearer

Request body

referencestring required

Unique invoice reference for your records (e.g. "INV-2026-0001").

amountinteger required

Invoice amount in COP. Must be between 3,000 and 550,000,000.

descriptionstring required

Invoice description shown to the customer.

redirectUrlstring uri required

URL where the customer is redirected after completing the payment flow.

customerDocumentNumberstring required

Customer's document or identification number.

documentType'cc' | 'ce' | 'nit' | 'ti' | 'ps' | 'cif' | 'ne' | 'rc' | 'ppt'

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).

customerNamestring

Customer's display name (optional).

contractstring

Contract identifier. Defaults to "00000" if not provided.

Response

Created invoice

idstring required

Unique invoice identifier.

referencestring

Merchant-provided invoice reference.

status'ready' | 'paid' | 'cancelled' | 'chargeback' required

Invoice status: ready (payment link active), paid, cancelled, or chargeback.

amountnumber required

Invoice amount in COP.

descriptionstring required

Invoice description.

contractstring required

Contract identifier.

expirationDatestring

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.

customerDocumentNumberstring required

Customer's document number.

customerNamestring

Customer's display name.

createdAtstring required

Invoice creation datetime (ISO 8601).

paymentDatestring date-time

When the invoice was paid. Present on paid and chargeback invoices.

paymentMethod'pse' | 'nequiButton' | 'bancolombiaButton' | 'breb' | 'card'

Payment method used. Present on paid and chargeback invoices.

paymentSource'whatsapp' | 'portal' | 'link'

Channel through which payment was made. Present on paid and chargeback invoices.

paymentAmountnumber

Amount actually paid in COP. Present on paid and chargeback invoices.

settlementDatestring

Expected settlement date (YYYY-MM-DD). Present on paid and chargeback invoices.

settlementTimestring

Expected settlement cycle. Present on paid and chargeback invoices.

paymentIdstring

Payment identifier. Present on paid and chargeback invoices.

paymentUrlstring uri required

Palomma hosted payment page URL for this invoice.

Changes

No recorded changes to this operation across all 1 revision of this API.