The following table provides links to all the available Portico transactions, including detailed documentation and code examples:
Transaction | Schema Documentation | Description |
---|---|---|
Activation | Request / Response | Activation is used to obtain the authentication token for the terminal hardware. |
AddAttachment | Request / Response | AddAttachment can be used to store and associate data (e.g., images, documents, signature capture, etc.) to a prior transaction. |
Authenticate | Request / Response |
Authenticate is used to authenticate a specific user. For this call, the header must include username and password. |
BatchClose | Request / Response | BatchClose is used to settle and close the current open batch. |
CancelImpersonation | Request / Response |
CancelImpersonation is used to terminate a previously started impersonation session. |
CashReturn | Request / Response |
CashReturn creates a log of a transaction that is returning cash to a customer. NOTE: This is processed offline. |
CashSale | Request / Response |
CashSale creates a log of a transaction, in which cash is collected from a customer. This is processed offline. |
CheckSale | Request / Response |
CheckSale transactions use bank account information as the payment method. There are sub-actions that can be taken as part of the CheckSale as indicated by the CheckAction field. |
CheckQuery | Request / Response | CheckQuery is used to query info about a check transaction. |
CheckVoid | Request / Response |
CheckVoid is used to cancel a previously successful CheckSale transaction. It can also be used to cancel a prior CheckSale transaction. This should be used in timeout situations or when a complete response is not received. |
ChipCardDecline | Request / Response | ChipCardDecline is used to record an offline decline by an EMV chip card. |
CreditAccountVerify | Request / Response | CreditAccountVerify is used to verify that the associated account is in good standing with the Issuer. |
CreditAdditionalAuth | Request / Response |
CreditAdditionalAuth is typically used in a bar or restaurant situation where the merchant obtains the payment information for an original CreditAuth but does not want to hold the card or ask for it on each additional authorization. This service has been deprecated. See CreditIncrementalAuth |
CreditAddToBatch | Request / Response |
CreditAddToBatch is primarily used to add a previously approved open authorization (CreditAuth, CreditOfflineAuth, or RecurringBillingAuth) to the current open batch. If a batch is not open, this transaction will create one. It also provides the opportunity to alter data associated with the transaction (i.e., add a tip amount). |
CreditAuth | Request / Response |
CreditAuth authorizes a credit card transaction. These authorization only transactions are not added to the batch to be settled. They can be added to a batch at a later time using CreditAddToBatch. Approved authorizations that have not yet been added to a batch are called open auths. |
CreditCPCEdit | Request / Response |
CreditCPCEdit attaches Corporate Purchase Card (CPC) data to a prior transaction. This information will be passed to the issuer at settlement when the associated card was a corporate card or an AMEX card. |
CreditIncrementalAuth | Request / Response | CreditIncrementalAuth adds to the authorized amount for a prior transaction. |
CreditIPQuery | Request / Response |
CreditIPQuery returns the Installment Payment terms available to the cardholder. This is currently only supported for the AP Region. Refer to the Authorization Platform section for further details. |
CreditOfflineAuth | Request / Response (Header only) |
CreditOfflineAuth records an authorization obtained outside of the gateway (e.g., voice authorization, chip card offline approval). These authorization only transactions are not added to the batch to be settled. They can be added to a batch at a later time using CreditAddToBatch. Approved authorizations that have not yet been added to a batch are called open auths. |
CreditOfflineSale | Request / Response | CreditOfflineSale records an authorization obtained outside of the gateway (e.g., voice authorization, chip card offline approval). |
CreditReturn | Request / Response |
CreditReturn allows the merchant to return funds back to the cardholder. Returns can be for the entire amount associated with the original sale or a partial amount. Returns made using the GatewayTxnId can be performed for up to one year from the original authorization date. For the Exchange host only, refunds may be processed offline or online, depending on merchant settings. To enable online refunds, contact your representative. For all other Authorization Platforms, refunds are sent online to the host and the host determines whether the issuer participates in online returns. |
CreditReversal | Request / Response |
CreditReversal cancels a prior authorization in the current open batch. This can be used in timeout situations or when a complete response is not received. In either case, the client is unsure of the outcome of the prior transaction. |
CreditSale | Request / Response |
CreditSale authorizes a credit card transaction. These authorizations are automatically added to the batch to be settled. If a batch is not already open, this transaction will create one. |
CreditTxnEdit | Request / Response | CreditTxnEdit allows the merchant to alter the data on a previously approved CreditSale, CreditAuth, CreditOfflineSale, or CreditOfflineAuth (i.e., add a tip amount). |
CreditVoid | Request / Response |
CreditVoid is used to cancel an open auth or remove a transaction from the current open batch. The original transaction must be a CreditAuth, CreditSale, CreditReturn, CreditOfflineAuth, CreditOfflineSale, RecurringBilling, or Recurring Billing Auth. |
DebitAddToBatch | Request / Response |
DebitAddToBatch is used to add a pre-authorized debit transaction to the open batch. If a batch is not open this transaction will create one. NOTE: For Canadian Interac debit only. |
DebitAuth | Request / Response |
DebitAuth obtains a pre-authorization of funds on a debit card. These authorization-only transactions are not added to the batch to be settled. They can be added to a batch at a later time using DebitAddToBatch. NOTE: For Canadian Interac debit only. |
DebitReturn | Request / Response |
DebitReturn allows the merchant to return funds from a prior debit sale back to the cardholder. Returns can be for the entire amount associated with the original sale or a partial amount. Returns made using the GatewayTxnId can be performed for up to one year from the original authorization date. Support for EMV PIN Debit has been added. |
DebitReversal | Request / Response |
DebitReversal cancels a previous DebitSale transaction. This should be used in timeout situations or when a complete response is not received. In either case, the client is unsure of the outcome of the prior transaction. Support for EMV PIN Debit has been added. |
DebitSale | Request / Response |
DebitSale authorizes a debit card transaction. Support for EMV PIN Debit has been added. |
EBTBalanceInquiry | Request / Response | EBTBalanceInquiry returns the available balance for an EBT account. |
EBTCashBackPurchase | Request / Response | EBTCashBackPurchase is used to purchase goods with EBT Cash Benefits. |
EBTCashBenefitWithdrawal | Request / Response | EBTCashBenefitWithdrawal is used to disburse cash from an EBT Cash Benefits account. |
EBTFSPurchase | Request / Response |
EBTFSPurchase is used to purchase goods with SNAP. |
EBTFSReturn | Request / Response |
EBTFSReturn is used to credit previously debited funds to a SNAP account for merchandise returned. |
EBTFSReversal | Request / Response |
EBTFSReversal cancels a previous EBTFSPurchase, EBTCashBackPurchase, EBTFSReturn, and EBTCashBenefitWithdrawal transactions. This should be used in timeout situations or when a complete response is not received. In either case, the client is unsure of the outcome of the prior transaction. |
EBTVoucherPurchase | Request / Response | EBTVoucherPurchase is obsolete and should no longer be used. |
EndToEndTest | Request / Response | EndToEndTest for internal use only. |
FindTransactions | Request / Response | FindTransactions is used to search all current gateway transactions based on provided filter criteria. |
GetAttachments | Request / Response | GetAttachments is used to retrieve attachments (i.e., documents, images, etc.) associated with a particular transaction. |
GetUserDeviceSettings | Request / Response | GetUserDeviceSettings is for internal use only. |
GetUserSettings | Request / Response | GetUserSettings is for internal use only. |
GiftCardActivate | Request / Response | GiftCardActivate is used to activate a new stored value account and load it with an initial balance. |
GiftCardAddValue | Request / Response | GiftCardAddValue loads an amount onto a stored value account. |
GiftCardAlias | Request / Response |
GiftCardAlias allows the client to manage stored account aliases. An alias is an alternate identifier used to reference a stored value account. |
GiftCardBalance | Request / Response | GiftCardBalance is used to retrieve the balance(s) for each currency supported by a stored value account. |
GiftCardCurrentDayTotals | Request / Response |
GiftCardCurrentDayTotals is used to retrieve stored value transaction totals for the current day. This transaction is obsolete and should no longer be used. FindTransactions can be used as an alternative. |
GiftCardDeactivate | Request / Response | GiftCardDeactivate is used to deactivate an active stored value account that otherwise has not been used. |
GiftCardPreviousDayTotals | Request / Response | GiftCardPreviousDayTotals is used to retrieve stored value transaction totals for the previous day. |
GiftCardReplace | Request / Response |
GiftCardReplace transfers balances from one stored value account to another. This is typically to replace a lost or stolen account with a new one or to consolidate two or more accounts into a single account. |
GiftCardReversal | Request / Response |
GiftCardReversal is used to cancel a prior stored value transaction. This should be used in timeout situations or when a complete response is not received. In either case, the client is unsure of the outcome of the prior transaction. |
GiftCardReward | Request / Response |
GiftCardReward is used when an account holder makes a payment using a payment form other than a stored value account (e.g., cash or credit card). The account holder may present their stored value account to earn points or other loyalty rewards, which would be added to their account. |
GiftCardSale | Request / Response | GiftCardSale is used to redeem value from a stored value account. |
GiftCardVoid | Request / Response |
GiftCardVoid is used to cancel a prior successful transaction. When voiding a transaction, all changes to the account are reversed, including any additional value added by rewards programs or automated promotions. |
Impersonate | Request / Response | Impersonate is for internal use only. |
InteracDeviceKeys | Request / Response | InteracDeviceKeys allows a merchants to re-synchronize the keys for Canadian Debit transactions. |
InvalidateAuthentication | Request / Response | InvalidateAuthentication is for internal use only. |
ManageSettings | Request / Response | ManageSettings is for internal use only. |
ManageTokens | Request / Response (Header only) | ManageTokens allows merchants to update information referenced by a specific multi-use token. |
ManageUsers | Request / Response | ManageUsers is for internal use only. |
ParameterDownload | Request / Response | ParameterDownload is used to initiate an EMV parameter download by clients interfacing to an EMV device. |
RecurringBilling | Request / Response | RecurringBilling authorizes a one-time or scheduled recurring transaction. |
RecurringBillingAuth | Request / Response |
Like the RecurringBilling service, this also authorizes a one-time or scheduled recurring transaction. However, these authorization only transactions are not added to the batch to be settled. They can be added to a batch at a later time using CreditAddToBatch. Approved authorizations that have not yet been added to a batch are called open auths. |
ReportActivity | Request / Response |
ReportActivity returns all activity between the client devices and gateway for a period of time. This can be filtered to a single DeviceId if needed. This report is obsolete and should not be used. FindTransactions can be used as an alternative. |
ReportBatchDetail | Request / Response |
ReportBatchDetail returns information on each transaction currently associated to the specified batch. This report is for the SiteId and DeviceId referenced in the header. |
ReportBatchHistory | Request / Response |
ReportBatchHistory returns information about previous batches over a period of time. This report is for the SiteId referenced in the header. |
ReportBatchSummary | Request / Response |
ReportBatchSummary returns a batch's status information and totals broken down by payment type. This report is for the SiteId and DeviceId referenced in the header. |
ReportOpenAuths | Request / Response |
ReportOpenAuths returns all authorizations that have not been added to a batch for settlement. This report is for the SiteId referenced in the header. |
ReportSearch | Request / Response |
ReportSearch returns transaction information for a specified time period. This report is obsolete and should not be used. FindTransactions can be used as an alternative. |
ReportTxnDetail | Request / Response |
ReportTxnDetail returns detailed information about a single transaction. This report is for the SiteId and DeviceId referenced in the header. |
RewardCashQuery | Request / Response |
RewardCashQuery returns the available points from a stored account, if any, and authorizes a loyalty transaction. It is applicable only for Reward Cash terminals in the AP Region and is for future use. |
RewardCashRedeem | Request / Response |
RewardCashRedeem is a loyalty transaction that redeems value from a stored account. This transaction is automatically added to the Reward Cash batch. It is applicable only for Reward Cash terminals in the AP Region and is for future use. |
SendReceipt | Request / Response |
SendReceipt is for internal use only. It allows a client to send a receipt from a prior transaction out to specific destinations. The prior transaction must belong to the SiteId and DeviceId referenced in the header. |
SurchargeEligibilityLookup | Request / Response | SurchargeEligibilityLookup allows merchants to verify whether surcharge can be applied to a card number. |
TestCredentials | Request / Response | TestCredentials validates the credentials passed in the header, but does not perform an action. |
Tokenize | Request / Response (Header only) |
Tokenize allows the client to request a multi-use token using the provided card data without having the card data verified by the issuer. Card input data may not be a Single Use token. |
TokenUpdaterHistory | Request / Response | TokenUpdaterHistory allows merchants to retrieve a counts or details report of token updates performed by the Automated Account Updater service. |