Welcome to the CORALIX API.
\nOur API allows you to integrate payment processing into your application quickly and securely. Through a simple REST interface, you can create payment sessions, process transactions, manage refunds, tokenize payment methods, and receive real-time transaction updates via webhooks.
\nThis documentation includes:
\nAll API communication is performed over HTTPS, and all request and response bodies are formatted as JSON.
\nWhether you are building a custom checkout, integrating a hosted payment page, or automating payment operations, this guide provides everything you need to complete your integration.
\nWe look forward to helping you build a reliable and secure payment experience.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"547480","collectionId":"0a887196-9c41-4c91-987b-983aa882d323","publishedId":"2sBXwyGnNB","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-06-29T08:53:48.000Z"},"item":[{"name":"PAYMENT FLOW","item":[],"id":"dee212b1-bb84-4779-8e35-50f05201d8eb","description":"1. Create a payment session — POST /v1/sessions
{ \"order_id\": \"order_123\", \"amount\": 15.00, \"currency\": \"USD\" }\n\nReturns the session (status: \"pending\"), a checkout_url, and the available payment_methods. Sessions expire after 30 minutes.
2. Process the payment — POST /v1/sessions/{sessionId}/pay
{\n \"payment_method_config_id\": \"<id from payment_methods>\",\n \"payment_data\": {\n \"card_number\": \"4242424242424242\",\n \"exp_month\": 12, \"exp_year\": 2030,\n \"cvv\": \"123\", \"holder_name\": \"John Doe\"\n }\n}\n\nReturns { status: \"success\", transaction_id, provider_ref }, or on a decline { status: \"failed\", decline_reason, decline_message }. Use Accept-Language: es or en to choose the message language.
3. Receive the webhook — Coralix POSTs a signed payment.success / payment.failed event to your configured endpoint. You don't call this; it's pushed.
GET /v1/sessions/{sessionId}/status — check a session and its transactions.GET /v1/transactions/{id}/attempts — see each attempt and its decline reason.order_id is unique per merchant. Retrying with the same order_id + amount + currency returns the same session (safe retries, no double charge). Reusing an order_id with a different amount or currency returns 409.
Errors return { \"error_code\", \"message\", \"request_id\" }. Declines are not errors — /pay returns 200 with status: \"failed\" and a decline_message.