Skip to main content
Create your first invoice in three steps.

​
1. Create an invoice

Send a POST request to /invoices: 
curl -X POST https://api.palomma.com/invoices \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "INV-2026-0001",
    "amount": 1850000,
    "description": "Canon de arrendamiento marzo 2026",
    "redirectUrl": "https://merchant.example.com/payments/return",
    "customerDocumentNumber": "900123456"
  }'
The response includes a paymentUrl.

​
2. Redirect the customer

Use the paymentUrl to redirect your customer straight to Palomma’s payment page (e.g. after they click “Pay” in your app). The link expires 5 minutes after creation, so it’s meant for immediate redirection rather than sending via email or WhatsApp.

​
3. Track status

Call GET /invoices/{id}. When status is paid, the invoice has been paid.