Skip to content

IPG

Process card payments through IPG: the credit card contract, the supported features and the test cards.

For PayFacs and ISOs that process through IPG. Ginger sends card payments to IPG with the store ID of the project, and IPG authenticates the customer with 3-D Secure (3DS). IPG uses the Credit Card contract of the project.

How it works

IPG is the card processor of your platform, or of the merchants you assign to it (see Payments). A card payment through IPG goes like this:

  1. The customer enters the card details on the hosted payment page, or in the merchant's own checkout. Ginger stores the card in its vault.
  2. Ginger starts the payment at IPG with the store ID of the project, and IPG runs 3DS 2 with the card issuer.
  3. IPG reports the result, and the transaction gets its final status.

When a low value exemption applies, Ginger asks IPG to skip 3DS. If the issuer doesn't grant the exemption, Ginger retries the payment with 3DS.

Contract

IPG gives you a store ID per merchant project. Fill it in on the Credit Card contract of the project: in the Admin portal, open the project, go to the Payment Method Contracts tab, switch on Credit Card and open it. With the Boarding API, set the credit-card contract of the project. American Express has its own amex contract.

The store ID goes in acceptor_id, together with acceptor_id_prefix: ask your Ginger contact what goes in each. A project without one can't start IPG payments. The contract also holds the brands and currencies of the project, the capture modes, the low value exemptions and the payout model. See the credit-card fields of Update a project contract in the API reference.

Payment methods and features

IPG
Payment methodscredit-card, apple-pay, google-pay
Card brandsVisa, Mastercard, American Express (with the amex contract) and the other brands of the contract
3-D SecureThrough IPG, 3DS 2, with low value exemptions
Sale and refundYes
Pre-authorisation, capture and voidYes, when enabled in the contract

For the requests, see Pre-authorizations and Refunds in the payment acceptance docs.

Test cards

Test with a project in test mode (status active-testing). Test payments go to the IPG test environment.

BrandCard number3DS flowChallenge code
Visa4147463011110083Frictionless
Visa4018810000100036Frictionless
Mastercard5239290700000028Frictionless
Mastercard5420711000210016Frictionless
American Express375987000169677Frictionless
Diners Club36849800000679Frictionless
Visa4018810001010010Fingerprint
Mastercard5420711000190010Fingerprint
American Express375987000169776Fingerprint
Visa4018810000150015Challenge0101 succeeds, 3333 fails
Mastercard5299910010000015Challenge4445 succeeds, 9999 fails
American Express375987000000005Challenge5678 succeeds, 3333 fails
Discover6011947300799885Challenge5678 succeeds, 3333 fails
Mastercard5204730000001011Fingerprint and challenge4445 succeeds, 9999 fails
American Express374245001711000Fingerprint and challenge5678 succeeds, 3333 fails
Discover6011947499999957Fingerprint and challenge5678 succeeds, 3333 fails

Next steps