Creating Orders as a Partner

Partners can create orders on behalf of their onboarded stores. The request body is identical to a standard order creation — the only difference is the authentication headers.

If you are a direct merchant (not a partner), see Creating Orders for the standard integration guide.

Authentication

Partner requests require three headers instead of one:

Header	Description
`merchant-key`	Identifies the target store you are creating the order for.
`X-API-Key`	Your partner API key.
`X-API-Secret`	Your partner secret key.

See Partner Authentication for details on obtaining these credentials.

Example

curl -X POST "https://api.wava.co/v1/orders" \
  -H "merchant-key: STORE_MERCHANT_KEY" \
  -H "X-API-Key: YOUR_PARTNER_API_KEY" \
  -H "X-API-Secret: YOUR_PARTNER_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "description": "Product purchase",
    "currency": "COP",
    "shopper": {
      "first_name": "Juan",
      "last_name": "Perez",
      "email": "juan@email.com",
      "phone_number": "+573001234567",
      "country": "CO"
    },
    "payment_gateway": {
      "id_payment_gateway": 1
    },
    "order_key": "partner-order-001"
  }'

The response is the same as a direct merchant order. All payment flows (Nequi, Daviplata, Breb) work identically. For the full request body reference and field descriptions, see Creating Orders. For gateway-specific payment flows, see Payment Flows.

Partner Authentication

Creating Links

Getting Started

Orders

Payment Flows

Payment Links

Partners

Webhooks

Integrations

Testing

Error Handling

Creating Orders

Creating Orders as a Partner

Authentication

Example

​Creating Orders as a Partner

​Authentication

​Example

Creating Orders as a Partner

Authentication

Example