curl -X POST "https://api.nevatal.com/api/v1/billing/payments" \
-H "Authorization: Bearer nvtl_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"invoiceId": "inv_001",
"amount": 178500,
"method": "transfer",
"reference": "BANK-REF-12345"
}'
{
"id": "pay_002",
"invoiceId": "inv_001",
"amount": 178500,
"currency": "COP",
"method": "transfer",
"status": "completed",
"reference": "BANK-REF-12345",
"paidAt": "2025-03-16T14:00:00Z"
}
{
"statusCode": 422,
"error": "Unprocessable Entity",
"message": "Payment amount exceeds invoice balance"
}
Billing
Create Payment
Record a payment against an invoice
POST
/
api
/
v1
/
billing
/
payments
curl -X POST "https://api.nevatal.com/api/v1/billing/payments" \
-H "Authorization: Bearer nvtl_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"invoiceId": "inv_001",
"amount": 178500,
"method": "transfer",
"reference": "BANK-REF-12345"
}'
{
"id": "pay_002",
"invoiceId": "inv_001",
"amount": 178500,
"currency": "COP",
"method": "transfer",
"status": "completed",
"reference": "BANK-REF-12345",
"paidAt": "2025-03-16T14:00:00Z"
}
{
"statusCode": 422,
"error": "Unprocessable Entity",
"message": "Payment amount exceeds invoice balance"
}
Body Parameters
string
required
The invoice to pay
number
required
Payment amount in COP
string
required
Payment method:
cash, card, transfer, otherstring
External transaction reference
string
Payment notes
object
Free-form data stored with the payment. The keys
source, chargeId, patientId, medicalRecordId, concept and reviewFlag are reserved for copago / cuota moderadora payments recorded from a payer charge: they are ignored here and on PUT /api/v1/billing/payments/{id}, where a payment’s stored reserved keys are kept.curl -X POST "https://api.nevatal.com/api/v1/billing/payments" \
-H "Authorization: Bearer nvtl_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"invoiceId": "inv_001",
"amount": 178500,
"method": "transfer",
"reference": "BANK-REF-12345"
}'
{
"id": "pay_002",
"invoiceId": "inv_001",
"amount": 178500,
"currency": "COP",
"method": "transfer",
"status": "completed",
"reference": "BANK-REF-12345",
"paidAt": "2025-03-16T14:00:00Z"
}
{
"statusCode": 422,
"error": "Unprocessable Entity",
"message": "Payment amount exceeds invoice balance"
}