Release 11.02.2025

Changelog

Orders and Payouts

Validation for orderNumber and payoutNumber:

• New length constraints: orderNumber and payoutNumber now must be at least 3 characters and no more than 255 characters.
  • This impacts the Create Order endpoint (see the orderNumber field).
  • This impacts the Create Payout Request endpoint (see the payoutNumber field).

affiliatedId Object in customer

• Both Create Order and Create Payout Request now support a new optional metaData object within the customer object. This includes the optional affiliatedId field for passing arbitrary values used for custom routing. Changes have been introduced to this endpoint, but its full functionality will be available in upcoming releases.

Orders

Customer Object Updates:

• In the Create Order endpoint, the firstName and lastName fields inside the customer object are now optional and may be null. This allows you to create orders without strictly requiring the customer’s name information.

Payment Page Language Parameter:

• A new optional language field is available under paymentPageDesign in the Create Order request:
  • Accepts an ISO 639-1 code (for example, "en" for English).
  • Unsupported languages will default to English.
  • If omitted, the payment page language will continue to be determined by the payer’s IP address.
  • Note: The parameter is accepted now, but actual language switching functionality will be activated in a future release.

Order Cancel and Refund Request Updates:

• The request body for the Cancel Order (in development) endpoint has been updated. The endpoint’s functionality remains under development and will be fully available in a future release.
• The request body for the Refund Order (in development) endpoint has also been updated. Similar to cancellation, its functionality is still in progress and not yet fully operational.

New payer Object in Create Order:

• In the Create Order endpoint, a payer object has been added. When instrumentType = card and dataEntryMode = h2h, you can send card data directly. This removes the need for the payer to manually enter card information on the payment page. Changes have been introduced to this endpoint, but its full functionality will be available in upcoming releases.

Payouts

Payout Endpoints Enhancements:

• In the Create Payout Request and Retrieve Required Payout Fields endpoints, new object cryptoWalletData has been added to the recipient and sender arrays.