Turn checkout payment methods on or off
Choose which methods buyers see on all your hosted checkouts from Portal → Payment methods, or limit a single link with `methods`, and understand why a method is hidden.
What you will do
Two things decide what a buyer sees: what VEXPay has enabled for your account, and what you have turned on. You control the second one, for every checkout at once or per link.
Steps: for every checkout
- Open Payment methods
In the portal, open Payment methods. It lists Card, Débito Inmediato, Pago Móvil, USDT, USDC and Colombian pesos, each with the currency it is paid in.
- Flip the toggles
Each change saves at once. Methods VEXPay has not enabled for you are greyed out as "Not enabled for your account".
- Keep at least one on
The portal refuses to turn off the last enabled method.
- A method you turn off disappears from every hosted checkout: portal payment links, product links and API checkout sessions.
- A change on Live also applies to your Test account.
- Direct payment API calls (for example
POST /v1/payments/vpos) are not affected.
Steps: for one checkout only
Send methods when you create a checkout session. Values: c2p (shown as Débito Inmediato), pago_movil, vpos (card), usdt, usdc, cop. Leave it out to offer everything your account accepts and has turned on.
curl --request POST "${API_URL}/v1/checkout/sessions" \
--header "content-type: application/json" \
--header "x-api-key: ${VEXPAY_API_KEY}" \
--data '{ "amountUsd": 50.00, "description": "Order #3007", "methods": ["usdt", "usdc"] }'Check that it worked
In Payment links, each active link lists "Buyers can pay with: …" and gives a reason for each hidden method. Open a checkout in a private window to see it as a buyer does.
| Reason shown | What it means | What to do |
|---|---|---|
| not enabled for your account | VEXPay has not enabled the method for your account | Ask VEXPay to enable it. |
| turned off in Payment methods | You turned it off | Turn it back on. |
| excluded on this link | The session's methods leaves it out | Create a session that includes it. |
| not available for sellers | Stablecoins and pesos are not offered on checkouts split with a seller | Expected; split checkouts take bolívar methods only. |
| receiving account not set up | Pago Móvil on Live without a complete receiving account | Contact VEXPay. |
| rate temporarily unavailable | No fresh exchange rate right now | Wait a few minutes; other methods keep working. |
| amount below the minimum | The peso price is under COP 20,000 | Raise the amount or let the buyer pick a quantity. |
| temporarily unavailable | The method cannot be offered at the moment | Retry later; contact VEXPay if it persists. |
If something goes wrong
| Symptom | Likely cause | What to do |
|---|---|---|
| 400 "Keep at least one payment method on." | You tried to turn off the last enabled method | Turn another method on first. |
400 invalid_data "Turned off in Portal → Payment methods: …" | A session names a method you turned off | Remove it from methods or turn it back on. |
| A toggle is greyed out | Not enabled for your account | Ask VEXPay to enable it. |
Related: Payment links · Browser checkout