Gateway Discovery

Before creating any order, you need to know which payment gateways are active for your store and what fields each gateway requires from the buyer.

Why this step matters

Each store has different payment gateways enabled depending on their configuration. The gateway discovery endpoint returns the exact list of available gateways, their IDs, and the required fields — so your integration adapts automatically without hardcoding gateway details.

Request

curl -X GET "https://api.wava.co/v1/orders/paymentGateways" \
  -H "merchant-key: YOUR_MERCHANT_KEY"

Response

The response includes an array of available gateways with their configuration:

{
  "result": {
    "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": false,
        "description": "Transferencia interbancaria con QR o clave",
        "gateway_logo": "https://cdn.wava.co/logos/breb.png",
        "supports_direct_api": true
      }
    ]
  }
}

Field	Meaning
`requires_phone`	The gateway uses `shopper.phone_number` to start the payment (Nequi push notification).
`required_shopper_national_id`	The gateway uses the shopper’s document (`id_number` + `id_type`) to start the payment (Daviplata).
`supports_direct_api`	The gateway can be used with `POST /v1/orders` (Direct Orders). If `false`, it is only available through payment links or hosted checkout.

How to use the response

Call the endpoint

Make a GET /v1/orders/paymentGateways request with your merchant-key header.

Display available gateways

Show the buyer only the gateways returned in the response. Use the provided gateway_logo URLs for gateway logos. For Direct Orders, only offer gateways with supports_direct_api: true.

Collect required fields

Nequi and Daviplata direct orders need the shopper fields described in Creating Orders; for Breb the shopper object is optional. On top of that, use the flags to know what the selected gateway uses: requires_phone (Nequi) or required_shopper_national_id (Daviplata).

Create the order

Pass the id_payment_gateway and collected fields to POST /v1/orders. See Creating Orders for the full request format.

Gateway-specific required fields

Gateway	`id_payment_gateway`	Fields the gateway uses	Direct Orders
Nequi	Returned by endpoint	`phone_number`	Yes
Daviplata	Returned by endpoint	`id_number`, `id_type`	Yes
Breb	Returned by endpoint	None (QR code / key generated from the order; `shopper` is optional)	Yes
Stripe	Returned by endpoint	Configured via dashboard	No

Do not hardcode id_payment_gateway values. Always use this endpoint to discover them dynamically — IDs may differ between environments and stores.

For gateway-specific payment flows (push notifications, OTP, QR codes), see Payment Flows.

Getting Started

Orders

Payment Flows

Payment Links

Partners

Webhooks

Integrations

Testing

Error Handling

Gateway Discovery

Gateway Discovery

Why this step matters

Request

Response

How to use the response

Gateway-specific required fields

​Gateway Discovery

​Why this step matters

​Request

​Response

​How to use the response

​Gateway-specific required fields

Gateway Discovery

Why this step matters

Request

Response

How to use the response

Gateway-specific required fields