Technical Bulletin: 25-Character Limit for Multi-Currency Transaction IDs

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.