Get available payment gateways

curl --request GET \
  --url https://api.wava.co/v1/orders/paymentGateways \
  --header 'merchant-key: <api-key>'

const options = {method: 'GET', headers: {'merchant-key': '<api-key>'}};

fetch('https://api.wava.co/v1/orders/paymentGateways', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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
      }
    ]
  }
}

Payment Gateways

Get available payment gateways

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:

Display payment options dynamically in your checkout
Determine which fields to collect from the buyer based on each gateway’s requirements
Get gateway logos and descriptions for UI display
Check which gateways support direct API orders vs. hosted checkout only

Amount validation (min/max limits per gateway) is performed during order creation, not during gateway discovery.

GET

orders

paymentGateways

Get available payment gateways

curl --request GET \
  --url https://api.wava.co/v1/orders/paymentGateways \
  --header 'merchant-key: <api-key>'

const options = {method: 'GET', headers: {'merchant-key': '<api-key>'}};

fetch('https://api.wava.co/v1/orders/paymentGateways', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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
      }
    ]
  }
}

Authorizations

merchant-key

string

header

required

Merchant key for store identification. Required for all API requests.

merchant-key: YOUR_MERCHANT_KEY

Query Parameters

currency

string

Filter gateways by currency. Defaults to your store's primary currency.

Pattern: ^[A-Z]{3}$

Example:

"COP"

Response

Payment gateways retrieved successfully

data

object

Show child attributes

API Reference

Create direct order