# Create a new payment.

**POST /api/payments/create-payment**

Given an amount (in USD or raw nano), returns a payment identifier (used to track the payment in the Madora system) and a nano address to serve as the destination for the payee. The response contains payment amounts, payment address, and a unique identifier created by Madora to refer to the payment later. Payments will fail if the user does not complete them within 15 minutes, and a new payment will need to be created. As part of Madora's AML policy, payments may not exceed $600. Additionally, payments are only available in supported regions.


## Servers


## Authentication methods
- Basic auth


## Parameters



### Body:  (object)

- **usdAmount** (string)
  Payment amount in USD. Required if nanoAmount is not provided.
- **nanoAmount** (string)
  Payment amount in Nano (Raw). Required if usdAmount is not provided.
- **orderId** (string)
  Optional identifier for the transaction for merchant use. Not used by Madora.
- **orderDescription** (string)
  Optional description for the transaction for merchant use. Not used by Madora.
- **paymentCustomer** (object)
  KYC (Know Your Customer) information used as part of Madora's required Anti-Money Laundering practices. Address information uses the Drupal Address Field (https://www.drupal.org/project/addressfield) to allow international address inputs. This means many fields will be optional for addresses in a given country. Descriptions provided describe the usage in a United States-based address. Other countries should use best judgement, or contact support@madora.io for best practices.


## Responses
### 200
200 OK

#### Body:  (object)
- **paymentIdentifier** (string)
  Unique identifier for the created payment.
- **usdAmount** (number(double))
  Required payment amount in USD. Will also except a string field, so long as it can be parsed into a number.
- **rawNanoAmount** (string)
  Required payment amount in Nano (Raw).
- **friendlyNanoAmount** (string)
  Required payment amount in Nano in a user-friendly format.
- **paymentAddress** (string)
  Nano address to be displayed to the user, which is where the payment should be sent to.

### 400
400 Bad Request

#### Body:  (object)
- **errorCode** (string)

- **errorMessage** (string)


### 401
401 Unauthorized

#### Body:  (object)
- **errorCode** (string)

- **errorMessage** (string)


### 500
500 Internal Server Error

#### Body:  (object)
- **errorCode** (string)

- **errorMessage** (string)



[Powered by Bump.sh](https://bump.sh)