---
title: "Create an Order"
method: POST
path: "/orders"
---

# Create an Order

`POST /orders`

## Request

- Base URL: `https://api.sandbox.waza.co/v2`
- URL: `https://api.sandbox.waza.co/v2/orders`
- Auth: API key in header `waza-x-key`

## Headers

- `waza-x-key` string

## Request body

- object
  - `beneficiary_id` string, required: ID of the beneficiary receiving the payment
  - `amount` string, required
  - `currency` string, required: Send currency in ISO string
  - `description` string, required
  - `client_reference` string: A uuid generated by your system
  - `quote_id` string, required: Can be used to force the order to fail if rates have changed between the time of quote generation and order creation
  - `metadata` object: Any additional structured metadata you may want to associate with this order, maximum of 10keys and total size of not more than 256bytes

## Response `200`

200

- object
  - `data` object
    - `id` string
    - `client_reference` unknown
    - `amount` integer
    - `currency` string
    - `receive_amount` integer
    - `receive_currency` string
    - `beneficiary_id` string
    - `state` string
    - `metadata` object
      - `extra` string
    - `fee_amount` integer
    - `fee_currency` string
    - `rate` number
    - `description` string
    - `destination` object
      - `type` string
      - `address` string
      - `business_name` string
      - `first_name` unknown
      - `last_name` unknown
      - `bank_name` string
      - `bank_code` string
      - `account_number` string
    - `timelines` object
      - `payout_sent_date` unknown
      - `arrival_date` unknown

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/waza/apis/b2b-payments-api.md) - [All operations](https://skmtc.dev/waza/apis/b2b-payments-api/llms.txt) - [OpenAPI document](https://skmtc.dev/waza/apis/b2b-payments-api/revisions/7d4685fefb9f?raw)