curl --request GET \
--url https://api.wava.co/v1/orders/paymentGateways \
--header 'merchant-key: <api-key>'{
"data": {
"store_currency": "COP",
"accepted_currencies": [
"COP"
],
"payment_gateways": [
{
"id_payment_gateway": 1,
"gateway_name": "Nequi",
"allowed_currencies": [
"COP"
],
"requires_phone": true,
"required_shopper_national_id": false,
"description": "Paga con tu celular usando Nequi",
"gateway_logo": "https://cdn.wava.co/logos/nequi.png",
"supports_direct_api": true
},
{
"id_payment_gateway": 2,
"gateway_name": "Daviplata",
"allowed_currencies": [
"COP"
],
"requires_phone": false,
"required_shopper_national_id": true,
"description": "Paga con Daviplata usando tu cédula",
"gateway_logo": "https://cdn.wava.co/logos/daviplata.png",
"supports_direct_api": true
},
{
"id_payment_gateway": 9,
"gateway_name": "Breb",
"allowed_currencies": [
"COP"
],
"requires_phone": false,
"required_shopper_national_id": true,
"description": "Transferencia interbancaria con QR o clave",
"gateway_logo": "https://cdn.wava.co/logos/breb.png",
"supports_direct_api": true
}
]
}
}Retrieve the list of payment gateways available for your store. Returns all active gateways with their specific requirements, supported currencies, and display information.
Use this endpoint to:
Amount validation (min/max limits per gateway) is performed during order creation, not during gateway discovery.
curl --request GET \
--url https://api.wava.co/v1/orders/paymentGateways \
--header 'merchant-key: <api-key>'{
"data": {
"store_currency": "COP",
"accepted_currencies": [
"COP"
],
"payment_gateways": [
{
"id_payment_gateway": 1,
"gateway_name": "Nequi",
"allowed_currencies": [
"COP"
],
"requires_phone": true,
"required_shopper_national_id": false,
"description": "Paga con tu celular usando Nequi",
"gateway_logo": "https://cdn.wava.co/logos/nequi.png",
"supports_direct_api": true
},
{
"id_payment_gateway": 2,
"gateway_name": "Daviplata",
"allowed_currencies": [
"COP"
],
"requires_phone": false,
"required_shopper_national_id": true,
"description": "Paga con Daviplata usando tu cédula",
"gateway_logo": "https://cdn.wava.co/logos/daviplata.png",
"supports_direct_api": true
},
{
"id_payment_gateway": 9,
"gateway_name": "Breb",
"allowed_currencies": [
"COP"
],
"requires_phone": false,
"required_shopper_national_id": true,
"description": "Transferencia interbancaria con QR o clave",
"gateway_logo": "https://cdn.wava.co/logos/breb.png",
"supports_direct_api": true
}
]
}
}Merchant key for store identification. Required for all API requests.
merchant-key: YOUR_MERCHANT_KEYFilter gateways by currency. Defaults to your store's primary currency.
^[A-Z]{3}$"COP"
Payment gateways retrieved successfully
Show child attributes