Create Trade
Create Trade
Authorizations
Bearer API Key authentication. Format: Authorization: Bearer {your_api_key}
Headers
The unique identifier of the request
Body
Payment amount, amount must be greater than 0, can be 0 only when using subscription payment method. Truncated to two decimal places
Transaction currency corresponding to the amount, encoded according to ISO4217
Third-party order ID
Payment business mode:
- onetime_payment: One-time payment, requires collecting customer payment information, pass
payment_method_datafield. - subscription: Initial subscription payment, requires collecting customer payment information, pass
payment_method_datafield, returnspayment_tokenfor subsequent subscription renewals upon successful payment - recurring_payment: Subscription renewal payment, requires passing
payment_tokento complete payment, no need to collect user payment information
Trade initiation time, UTC format, example: 2025-07-02T15:04:05Z
Client domain information, Fixed value: checkout.subotiz.com
Subotiz customer ID, associate with existing customer in Subotiz, choose one with customer_data field, use this field when you need to associate with existing customer
Customer data, create customer object in Subotiz, choose one with customer_id field, use this field when you need to create new customer.
A set of key-value pairs that can be attached to an object, allowing you to store additional information in a structured format.
Customer payment token, used for subscription renewal, required when using recurring_payment payment method.
Redirect page after payment channel accepts successfully in scenarios like 3DS redirect payment
Customer payment information, required for initial subscription payment when using subscription payment method
If supported, the field, Transaction Summary, will be passed to the payment provider via its API. Currently, payments for amounts greater than zero via Subotiz Payments are supported only.
Source information of the customer