Payment gateway for Venezuela, built around Pago Móvil
ATLAS is a payment gateway for Venezuela: buyers pay you in bolívars by Pago Móvil from their own banking app. You receive USDT for each completed order, and you can pay people back by Pago Móvil / bank transfer.
For merchants with buyers in Venezuela
If you sell to people in Venezuela, ATLAS takes their Pago Móvil payments on local accounts and credits your balance in USDT, so you can serve the market without a Venezuelan bank account or a VES position of your own.
Pay-outs go back through the same integration on one rail, Pago Móvil / bank transfer, with the recipient's phone, cédula, bank and account number. Everything else ATLAS offers merchants is on the merchants page.
The three details behind a Pago Móvil payment
Venezuelan buyers pay from their own banking app with Pago Móvil, the country's interbank mobile payment service. Instead of an account number they enter a phone number, a cédula (the national ID number) and a bank, and those are the details ATLAS returns for each pay-in.
The Pago Móvil page covers the API fields in both directions.
- Phone +58 412 123 4567
- Cédula V-12345678
- Bank Banesco
Pay-ins by Pago Móvil
Send POST /api/merchant/pay-in with geo 2 (or Venezuela), currency VES and an amount with two decimal places. paymentMethod is optional: leave it out and any bank in the network can serve the order over Pago Móvil. GET /api/merchant/payment-methods?geo=Venezuela lists the method codes contracted for your account.
The response gives you everything the buyer needs: the account holder, the bank, the phone, the cédula, the exact amount and the deadline. When an order is served through a partner route, the response can also carry a destination account number in cbu next to the Pago Móvil details.
In Venezuela requiresManualConfirmation is always true. ATLAS checks each incoming Pago Móvil by hand before the order is marked paid, so credit your customer when pay_in.completed arrives or the status endpoint returns Completed.
The request and response fields are on the Pago Móvil page, and pay-ins shows the flow in every market.
Pay-outs by Pago Móvil / bank transfer
Venezuela has one pay-out rail, Pago Móvil / bank transfer. ATLAS reserves the USDT from your pay-out balance, charges it once the transfer is confirmed, and a signed webhook reports the outcome. The Pago Móvil pay-out fields are on the method page, and statuses, retries and failure reasons for every market are on the pay-outs page.
Bolívars in, USDT out
Orders are priced in VES. The create response tells you the order's USDT value, fixed when it is created, which is what the order adds to your balance once it completes.
Your balance stays in USDT, and auto-settle or a withdrawal on request sends it to your TRC-20 wallet.
Connecting in Venezuela: the H2H API
Venezuela connects through the H2H API. The hosted and embedded pay page is available in India and South Korea only, and a Venezuelan request with checkout is refused with CHECKOUT_NOT_SUPPORTED, without creating a pay-in. You show the Pago Móvil details in your own checkout.
Requests are signed with HMAC-SHA256 over the timestamp and the body. merchantOrderId makes retries safe, because a repeated id returns the original order. Signed webhooks report final statuses and dispute events, with up to 10 delivery attempts. Each pay-in waits for a manual confirmation, so your order flow should wait for the webhook too. The developers hub explains signatures, webhooks and the sandbox.
What a buyer in Venezuela does
-
Your checkout shows the phone number, the cédula, the bank and the account holder, with the amount in VES and the time left.
Give each detail its own copy button.
-
The buyer opens their banking app, chooses Pago Móvil and enters those three details and the amount.
-
Once the payment is checked, the order moves from WaitingPayment to Completed and your server gets pay_in.completed.
An order the buyer doesn't pay in time becomes Expired. If their money arrives after that, the payment can still be confirmed, which moves the order to Completed and fires pay_in.completed, so treat a late completion as a normal one.
How to start in Venezuela
-
Send us your volume and tell us whether you need pay-ins, pay-outs or both.
-
Build in the sandbox with the Venezuela view of the API docs.
Contracts match production.
-
Run a Pago Móvil pay-in and a pay-out through to the webhook.
-
Switch to production keys.
Limits and terms are agreed before the first live order.
FAQ
How do buyers in Venezuela pay?
By Pago Móvil from their banking app, to the phone number, cédula and bank that ATLAS returns for their order, in VES.
What details does a Pago Móvil pay-out need?
The recipient's Pago Móvil details and bank account number, their name and the amount in VES. The Pago Móvil page lists the fields.
Why does every Venezuelan pay-in need manual confirmation?
ATLAS checks each incoming Pago Móvil by hand before the order is marked paid. Wait for pay_in.completed or poll the status before you credit the customer.
Can I use the hosted payment page in Venezuela?
No. It works in India and South Korea only. Venezuelan orders go through the H2H API, and your checkout shows the Pago Móvil details.
Do I have to send a payment method?
No. Leave paymentMethod out and any bank in the network serves the order over Pago Móvil.
What if the buyer pays after the order expires?
The payment can still be confirmed. The order moves from Expired to Completed and you receive pay_in.completed.
How am I paid for payments in Venezuela?
In USDT, paid out to your TRC-20 wallet by auto-settle or on request.