FAQ
You may find answers to your question here. If not, please contact us, and we will be happy to help you.
Q: How long is a Credit Card Reservation valid?
This depends on the Issuing Bank.
Master Card stipulates that a reservation must be held for at least 3 bank days.
Reservations placed on Visa cards must be valid for 7 days.
In practice a reservation is typically still valid after 28 days.
Even if - upon Capture - a reservation is no longer valid AltaPay will try to obtain a new reservation.
Q: What should I do if a Capture has failed?
Unless the error message leads you to think otherwise, you should stall the shipment and ask
your customer to pay again. If the customer's card has expired, they must use another card
or means of payment.
Q: When I tried to Capture a Reservation, the Payment ended up being 'reauth_failed', why?
If we try to capture a reservation and it fails, we will try to create a new Reservation (a 'reauth').
If this fails, the capture ultimately fails with the status 'reauth_failed'.
Q: When is 3D-Secure used?
Q: I am seeing failures on PBS with the message 'Suspected Fraud', should I be alarmed?
No, this error message typically means that the user has mistyped his CVV or chosen an unrealistic expiry date.
Q: I have refunded a "MasterCard Direct" transaction, but the card holder claims that the reservation still stands, can this be true?
Yes, the issuing bank (Danske Bank) behind the "MasterCard Direct" cannot release reservations even though they are asked to by the Acquiring Bank.
You can inform the card holder that the reservation will perish with time - or ask them to contact their bank.
For the reservation to be released a fax with the full card number, amount, and date must be sent to the issuing bank.
Q: How do I reconcile my Dankort transactions, the reference text on my bank statement says: "DKSSL 1402 5012345123456"?
The above reference text can be read as follows: "DKSSL14025012345123456"
DKSSL (Internet transaction)
1402 (Date PBS transferred the funds to your account, typically next day)
5012345 (Your PBS-id, in Danish Forretningsnummer)
123456 (Our reference, the payment_id posted back to you and used for capture/refund)
DKSSL (Internet transaction)
1402 (Date PBS transferred the funds to your account, typically next day)
5012345 (Your PBS-id, in Danish Forretningsnummer)
123456 (Our reference, the payment_id posted back to you and used for capture/refund)
Q: What are the possible values for PaymentSchemeName in the API XML response?
- Visa
- Visa Electron
- Dankort
- MasterCard
- Maestro
- JCB
- Diners
- Discover
- American Express
- Forbrugsforeningen
- Unknown Card
- ELV
- TestBank
- Sofortbanking
- DnB NORD Lithuania
- Envoy
- Handelsbanken Finland
- Inteligo Financial Services
- Nordea Finland
- Nordea Lithuania
- Nordea Sweden
- Paysafe Card
- Pohjola Finland
- Przelewy24
- Alior Bankiem
- Allianz Bank
- BZ WBK Poland
- eSKOK Poland
- ING Bank Slaski
- mBank mTransfer Poland
- mPay Poland
- MultiBank Poland
- Przelew24 CreditCard
- Przelew24 Prepaid
- Przelew24 Traditional
- Sampo Finland
- SEB Lithuania
- Swedbank Lithuania
- TestEPayment
- Test iDeal
- Gothia PayByBill
- Klarna
- Test Invoice
- PayPal
- Test Wallet
- Paysera
- WyWallet
- TestMobile
- Test gift card
- PPS gift card
- SVS gift card
- Laser
- ViaBill
- SantanderNorway Invoice
- SantanderNorway Here And Now
- SantanderNorway Here And Now Student
- Swish
Q: How should I handle the SEPA mandate when doing ELV Bank Payments?
The mandate reference sent to the consumer should be the same as the orderid passed to the AltaPay API.
Q: Which content headers can I use for resources (CSS, images, fonts) on the callback pages (form, okay, fail)?
For security reasons we only allow some content types to be served as resources on the payment pages, so the headers have to be one of the following:
- image/*
- application/x-font-woff
- application/font-woff
- application/vnd.ms-fontobject
- application/x-font-ttf
- application/font-sfnt
- application/font-tdpfr
- text/css
- .eot -> application/vnd.ms-fontobject
- .svg -> image/svg+xml
- .ttf -> application/x-font-ttf or application/font-sfnt
- .woff -> application/x-font-woff
- .pfr -> application/font-tdpfr
Q: Is there a schema file for the xml responses?
Yes, it can be downloaded here: APIResponse.xsd
Q: What is the difference between Declined and Failed response?
None. Failed is an old (legacy) term used before. Declined defines much better the actual status of the response.
Q: Why I received an Open status when doing a recurring charge on an Agreement with MobilePay Subscription?
The Reserve and Capture is handled by MobilePay internally. The payment will be automatically updated once we receive a notification from them. This processing is expected to take 2 days.