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.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article