Skip to main content

​
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:
HeaderDescription
merchant-keyIdentifies the target store you are creating the order for.
X-API-KeyYour partner API key.
X-API-SecretYour 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.