View the Project on GitHub PineapplePayments/pineapple-developer-center
These questions relate to the Augusta EMV Integration Guide.
No. The Transax idTech Augusta solution and JavaScript Library include logic to force EMV usage when the card is EMV enabled. MSR is only allowed in “fallback” mode (if an EMV chip card fails 3 times) or if the card is not EMV capable. This protects your merchants from potential increased decline rates or chargeback risks.
No. You do not need and will not be able to decrypt device payloads. The Transax API only accepts encrypted device payloads.
Transax does not offer a test environment. Instead, you should set up a real merchant account and trigger transactions through that using real credit (or debit) cards.
If needed, MasterCard offers test cards, which can be ordered on their Test Card site. Email MasterCard at 2series_test_cards@mastercard.com to request access to the card ordering site. The minimum load amount for a card is $5 and the minimum number of cards is 5. There is a 2% load fee and a $9.99 handling fee. The cards are mailed out within 48 hours of the order.
TransactionType) should I use?Generally, the TransactionType of sale will be appropriate for most use cases. If you conduct Authorizations that are later Captured, then TransactionType of auth followed by a capture transaction should be used - please contact your sales agent to discuss if this use case is appropriate.
When conducting returns, the specific state of the transaction dictates which TransactionType to use:
void can be submitted before a transaction settles in order to essentially stop it from happening. This requires passing the originating TransactionId in the API call.refund is used after a transaction settles in order to send the money back to the cardholder. This requires passing the originating TransactionId in the API call.credit is transaction is to send money to a cardholder without an originating sale. This requires passing a payment method in the API call.For further information on the update and adjustment transactions, please refer to quesiton How do I implement Tipping?, and How do I adjust informational fields in a transaction?.
A tip can be executed by using the TipAmount parameter. The Amount is not inclusive of TipAmount - the total Authorization (i.e. charge to the cardholder) will be equal to the Amount + TipAmount.
There are two patterns to adding this tip:
TipAmount is known at the time of the initial transaction, it should be included as part of that transaction.TipAmount is added after the initial transaction, it should be included as part of an API call with TransactionType of adjustment. This requires passing the originating TransactionId in the API call.// Open question: Need to validate what Transax actually does for tipping - especially for things like adding Tips to Sales. Does it allow tips after settlement? What validation rules apply?
The API allows you to pass many optional fields that are not required for a transaction to succeed, but are used for various other features or reporting. Examples of these fields include the Custom Fields, informational amounts liek Tax, and shipping information.
These fields can be updated by initiating an API call with TransactionType of update. This requires passing the originating TransactionId in the API call.