Technical Bulletin: 16-Character Limit for Transaction ID

1. The Requirement

Please be aware of an important restriction regarding the length of the merchantTransactionId.

Due to new requirements from our acquiring bank partners and mandates from Visa and Mastercard for 3D Secure 2, the merchantTransactionId parameter is now restricted to a maximum of 16 characters.

2. Consequence of Failure

Any transaction request sent with a merchantTransactionId longer than 16 characters will fail.

The system will return the following specific error code and message:

transaction declined (format error) (800.100.156)

3. Example of a Failing Request

The example POST request below will fail because its merchantTransactionId ("THIS-ID-IS-TOO-LONG-123") is longer than the 16-character limit.

{  "authentication.entityId": "...",  "amount": "92.00",  "currency": "ZAR",  "paymentType": "DB",  "merchantTransactionId": "THIS-ID-IS-TOO-LONG-123"
}

Summary & Action Required

To prevent payment failures, please ensure that your system generates a merchantTransactionId that is 16 characters or less for all transaction requests sent to Peach Payments.