Skip to main content

​
Quick Start

This guide will help you create your first payment using the LuxCore API.

​
Prerequisites

1

Obtain your API keys

API keys are provided by the LuxCore team during your merchant onboarding. Contact your account manager or reach out to developers@lux-core.io to request access.
2

Choose your environment

Use a test key (qp_test_*) for development. Switch to a production key (qp_prod_*) when you’re ready for production.
Merchant accounts and API keys are created by the LuxCore team. Self-registration is not available.

​
Create Your First Payment

Let’s create a bank transfer deposit payment (customer pays to you):
  • ARS (Argentina)
  • MXN (Mexico)
  • UYU (Uruguay)
curl -X POST "https://api.lux-core.io/api/v1/payments" \
  -H "X-API-Key: qp_test_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100000,
    "currency": "ARS",
    "method": "bank_transfer",
    "type": "deposit",
    "merchant_reference": "order_12345",
    "customer": {
      "name": "Juan Perez",
      "email": "juan@example.com"
    }
  }'

​
Response

  • ARS Response
  • MXN Response
  • UYU Response
{
  "transaction_id": "pay_1234567890_abcdefgh",
  "status": "processing",
  "amount": 100000,
  "currency": "ARS",
  "method": "bank_transfer",
  "type": "deposit",
  "merchant_reference": "order_12345",
  "created_at": "2025-01-21T10:30:00Z",
  "instructions": {
    "bank_name": "Banco Nacion",
    "cbu": "0110012345678901234567",
    "alias": "LUXCORE.PAGOS",
    "beneficiary": "LuxCore Platform S.A."
  }
}

​
Understanding the Response

FieldDescription
transaction_idUnique payment identifier. Use this to track the payment.
statusCurrent payment status. Deposits start as processing, withdrawals as pending.
instructionsBank details for the customer to complete the transfer (CBU/CLABE depending on currency)

​
What’s Next?

Set up Webhooks

Receive real-time notifications when the payment completes

Payment Types

Learn about deposits, withdrawals, and payment pages

Test Your Integration

Use test mode to simulate different scenarios

Go Live

Switch to production when you’re ready

​
Common Issues

Make sure you’re including the X-API-Key header with a valid API key.
Check that all required fields are present and properly formatted. The amount should be in minor units (centavos for MXN).
Ensure the payment method is enabled for your merchant account in the dashboard.