Quick Start This guide will help you create your first payment using the LuxCore API.
Prerequisites
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.
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" } }'
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": "MXN", "method": "spei", "type": "deposit", "merchant_reference": "order_12345", "customer": { "name": "Juan Perez", "email": "juan@example.com" } }'
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": "UYU", "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" , "fee_amount" : 4500 , "net_amount" : 95500 , "created_at" : "2025-01-21T10:30:00Z" , "expires_at" : "2025-01-21T10:45:00Z" , "bank_details" : { "amount" : "100000" , "purpose" : "Payment pay_1234567890_abcdefgh" , "currency" : "ARS" , "bank_name" : "Banco Nacion" , "swift_code" : null , "account_holder" : "LuxCore Platform S.A." , "account_number" : "0110012345678901234567" } }
{ "transaction_id" : "pay_1234567890_abcdefgh" , "status" : "processing" , "amount" : 100000 , "currency" : "MXN" , "method" : "spei" , "type" : "deposit" , "merchant_reference" : "order_12345" , "fee_amount" : 4500 , "net_amount" : 95500 , "created_at" : "2025-01-21T10:30:00Z" , "expires_at" : "2025-01-21T10:45:00Z" , "bank_details" : { "amount" : "100000" , "purpose" : "Payment pay_1234567890_abcdefgh" , "currency" : "MXN" , "bank_name" : "STP" , "swift_code" : null , "account_holder" : "LuxCore Platform S.A. de C.V." , "account_number" : "646180157000000001" } }
{ "transaction_id" : "pay_1234567890_abcdefgh" , "status" : "processing" , "amount" : 100000 , "currency" : "UYU" , "method" : "bank_transfer" , "type" : "deposit" , "merchant_reference" : "order_12345" , "fee_amount" : 4500 , "net_amount" : 95500 , "created_at" : "2025-01-21T10:30:00Z" , "expires_at" : "2025-01-21T10:45:00Z" , "bank_details" : { "amount" : "100000" , "purpose" : "Payment pay_1234567890_abcdefgh" , "currency" : "UYU" , "bank_name" : "BROU" , "swift_code" : null , "account_holder" : "LuxCore Platform S.A." , "account_number" : "001234567890" } }
Understanding the Response Field Description transaction_idUnique payment identifier. Use this to track the payment. statusCurrent payment status. Deposits start as processing, withdrawals as pending. bank_detailsBank details for the customer to complete the transfer (account number, holder, etc.) fee_amountCommission fee in minor units net_amountAmount after fee deduction in minor units
What’s Next? 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).
Payment method unavailable
Ensure the payment method is enabled for your merchant account in the dashboard.
