1. Scope: Multi-Currency Transactions Only
This restriction applies specifically to merchants using our Multi-Currency functionality. This service is facilitated by our third-party partner, Planet Payments.
If you only process transactions in ZAR, the standard 16-character limit applies.
2. The Requirement
For all multi-currency transaction requests, the merchantTransactionId parameter is restricted to a maximum of 25 characters.
3. Consequence of Failure
Any multi-currency transaction request sent with a merchantTransactionId longer than 25 characters will fail.
The system will return the following specific error code and message:
transaction declined (format error) (800.100.156)
4. Example of a Failing Request
The example POST request below would fail because its merchantTransactionId ("THIS-MULTI-CURRENCY-ID-IS-TOO-LONG") is longer than the 25-character limit.
{ "authentication.entityId": "...", "amount": "10.00", "currency": "USD", "paymentType": "DB", "merchantTransactionId": "THIS-MULTI-CURRENCY-ID-IS-TOO-LONG"
}
Summary & Action Required
If you are using our Multi-Currency service, please ensure your system generates a merchantTransactionId that is 25 characters or less to avoid payment failures.