Create Order
POST/order
Use this endpoint to initiate a new order
Request​
- application/json
Body
The unique identifier for the shop creating the order. How to get your shopId
order objectrequired
Container for order-related information.
Possible values: <= 255 characters
A unique identifier for the order that you must generate on your side. The orderNumber
should be specific to the shopId
or your company (depending on your company's settings) and must be unique for every order and payout within each shopId
or your company (depending on your company's settings).
cost objectrequired
Holds the financial details of the order.
The total order price, formatted as a decimal string with a period (.) as the decimal separator. The number of decimal places should comply with the ISO 4217 standard for the specified currency.
Possible values: >= 3 characters
and <= 3 characters
Specifies the currency in ISO 4217 alphabetic code format, consisting of 3 uppercase letters.
customer object
Container for customer-specific information.
Possible values: <= 255 characters
A unique identifier for the customer. The customerId
can either be unique within a shop or across the entire company/merchant. To determine the setting for your shop, check the admin panel of your merchant account under the settings menu in the field 'External customer ID unique for'.
Possible values: <= 255 characters
First name of the customer.
Possible values: <= 255 characters
Last name of the customer.
Possible values: <= 255 characters
Middle name of the customer, if applicable.
Customer's phone number, in international format.
Possible values: <= 255 characters
Email address of the customer.
paymentSettings objectnullable
Container for payment method details. Using paymentSettings
, you can select the method to process the payment.
To fill out the paymentSettings
object and obtain other information about payment methods available for your shop ID, use Retrieve Payment Methods endpoint.
Possible values: [cnp
, card_present
, moto
, recurring
, saved_card
, redirect
]
This field specifies the method by which payment data is entered and should only be used when instrumentType
== card
. Payment Entry Modes for instrument type card
Possible values: [card
, wallet
, bank_transfer
]
Specifies the instrument type. See available instrument types
Determines which payment provider should be used to process the payment.
Identifies the specific acquirer responsible for processing payments.
Possible values: [bank_wire
, sepa
, swift
, sbp
, card2card
, pix
, online_banking
, qris
, promptpay
, vietqr
, vietnambanksqr
, virtual_account
, khipu
, giropay
, eps
, open_finance
]
Applicable only when instrumentType
is bank_transfer
. Specifies the type of bank transfer. See details about transferType. If instrumentType
is bank_transfer
and transferType
is not provided, but there is only one possible transferType
configured for the shop, it will be selected automatically by the system.
Possible values: [qr
, redirect
, h2h
]
Methods for customer data entry to process payment:
redirect - the customer enters payment information on the provider's (acquirer's) page via redirect;
h2h (host2host) - the customer enters payment information on our payment page;
qr - the customer scans a QR code and enters information on the aggregator's side.
Default value: true
Set to true
or omit this parameter for one-stage payments where funds are automatically captured. Set to false
for two-stage payments requiring manual capture. How to work with two-stage payments
Sets the payment time limit in RFC 3339 format including the UTC zone. The default order lifetime is 24 hours.
Warning: We strongly advise against using this field unless absolutely necessary. Use of the timeLimit
field is recommended only if you fully understand its implications.
Once the specified time limit is reached, the transaction will be stopped regardless of the payment status with the provider.
redirectUrls objectnullable
Container for URLs to redirect to post-payment.
URL to redirect the user to after a successful payment completion. If not specified, the default will be the URL of the shop that created the order.
URL to redirect the user to in the event of a payment failure. If not specified, the default will be the URL of the shop that created the order.
Possible values: Value must match regular expression ^https:\/\/.*
This parameter allows you to specify a webhook URL for receiving notifications about order status changes for this specific order. If provided, notifications about the order status changes will be sent to this URL instead of the general webhook URL set for the shop.
Use this field to specify which alias should be applied for this order. The alias ensures that the correct payment configuration is used.
This value is obtained from the paymentSettingsAlias
field in the Retrieve Payment Methods endpoint.
For more detailed information about how to use aliases, refer to the Alias Documentation
paymentPageDesign objectnullable
A code for customizing the payment page's appearance, set through technical support.
Possible values: [redirect
, iframe
]
Defines the method of integrating the payment form on your website. 'redirect' takes the user to a hosted payment page, ensuring a separate and secure environment for transaction processing. 'iframe' embeds the payment form directly within your website, offering a seamless and integrated user experience without navigating away from your site. Information about redirect, Information about iframe
Responses​
- 200
Order successfully created
- application/json
- Schema
- Example (from schema)
Schema
data objectrequired
A unique identifier for the order, generated by the merchant, and specific to each shopId
.
URL directing the user to the payment interface.
{
"data": {
"orderNumber": "56573FDFVFDBWF",
"paymentLink": "https://someurlwhereyoucanspendyourmoney.com"
}
}