There are two invoice number fields in the Portico Transaction request messages, one in the AdditionalTxnData block and the other in the DirectMktData block. These fields are handled differently depending on the host and the transaction type.
Exchange
- Invoice number is sent to the host for credit messages only
- When either Invoice Number field is populated, the value passed in the Portico request is sent to the Exchange host
- When both Invoice Number fields are populated, the value in Direct Market Data takes precedence and is passed to the Exchange host
- If neither invoice number field is populated, then Portico has logic to send the GatewayTxnId of the transaction as Invoice Number to the Exchange host for Credit transactions only
- If the value passed in the transaction request or the value of the Gateway Txn Id is less than 10 characters, the value will be left zero-padded to 10 total characters before being sent to the host
GSAP-NA & GSAP-AP
- Invoice number is sent to the host for credit and debit messages
- For credit transactions, an invoice number value is passed for all Industry Codes for all card types to help a merchant to qualify for the best interchange rates
- For debit transactions, an invoice number value is passed when the industry code is H (lodging), E (ecommerce), or D (Direct Marketing/MOTO)
- If a value is not passed from the POS, the Gateway Txn Id is populated and sent to the host
- This is not sent out to the debit issuer, but is logged for reporting and reconciliation purposes
- When either Invoice Number field is populated, the value passed in the Portico request is sent to the GSAP host
- When both Invoice Number fields are populated, the value in Direct Market Data takes precedence and is passed to the GSAP host
- If neither invoice number field is populated, then Portico has logic to send the GatewayTxnId of the transaction as Invoice Number to the GSAP host during authorization
- For GSAP-NA merchants, if the value passed in the transaction request or the value of the Gateway Txn Id is less than 10 characters, the value will be left zero-padded to 10 total characters before being sent to the host
GNAP-UK
- Invoice Number is not sent to the GNAP host