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:
- 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.
- Ginger starts the payment at IPG with the store ID of the project, and IPG runs 3DS 2 with the card issuer.
- 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_, together with acceptor_: 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 methods | credit-card, apple-pay, google-pay |
| Card brands | Visa, Mastercard, American Express (with the amex contract) and the other brands of the contract |
| 3-D Secure | Through IPG, 3DS 2, with low value exemptions |
| Sale and refund | Yes |
| Pre-authorisation, capture and void | Yes, 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.
| Brand | Card number | 3DS flow | Challenge code |
|---|---|---|---|
| Visa | 4147463011110083 | Frictionless | |
| Visa | 4018810000100036 | Frictionless | |
| Mastercard | 5239290700000028 | Frictionless | |
| Mastercard | 5420711000210016 | Frictionless | |
| American Express | 375987000169677 | Frictionless | |
| Diners Club | 36849800000679 | Frictionless | |
| Visa | 4018810001010010 | Fingerprint | |
| Mastercard | 5420711000190010 | Fingerprint | |
| American Express | 375987000169776 | Fingerprint | |
| Visa | 4018810000150015 | Challenge | 0101 succeeds, 3333 fails |
| Mastercard | 5299910010000015 | Challenge | 4445 succeeds, 9999 fails |
| American Express | 375987000000005 | Challenge | 5678 succeeds, 3333 fails |
| Discover | 6011947300799885 | Challenge | 5678 succeeds, 3333 fails |
| Mastercard | 5204730000001011 | Fingerprint and challenge | 4445 succeeds, 9999 fails |
| American Express | 374245001711000 | Fingerprint and challenge | 5678 succeeds, 3333 fails |
| Discover | 6011947499999957 | Fingerprint and challenge | 5678 succeeds, 3333 fails |
Next steps
- Processor contracts: contracts, capture modes and low value exemptions.
- Test data for the merchants' developers.