Overview
Wallet Payments for Apple Pay and Google Pay allow users the ability to submit a payment via Apple Pay or Google Pay through the Payrix Hosted Payment Page (HPP). This functionality is only available for one-time payments via the Payrix HPP and available with the Pay Now invoices for Xero.
...
Wallet Payment Compatibility
Available | |
|---|---|
REST API HPP | √ |
REST API HPP + Custom Disbursement | √ |
REST API HPP + Save payer | × |
SOAP API HPP | √ |
HPP Olite | × |
HPP Salesforce – Pay Now | √ |
HPP Salesforce – Recurring | × |
HPP Simple Invoice | √ |
HPP Payment Recovery | × |
Xero – Pay Now | √ |
Xero - Recurring | × |
...
Implementing the use of Wallet Payments via the Payrix HPP
Wallet transaction via Payrix HPP
The Payrix platform offers the ability to utilise the Payrix Hosted Payment Page which is implemented via a re-direction to the Payrix Payment page. This offering is the simplest way to integrate a payment solution to your software with minimal development work required.
The process for using the Payrix HPP token is simply:
Call the POST Generate HPP Token to obtain a token and a redirect URL.
Redirect your customer to the URL you received with the token.
After your customer has completed the form we will redirect them back to your website using the returnURL you provided when generating the token.
Call the token lookup endpoint to obtain the result of the token.
| Info |
|---|
Please note the token is valid for 20 minutes. You may wish to use a landing page to trigger this if the page will not be completed as part of the flow. |
...
How to determine the result of a Wallet transaction via Payrix HPP
Within the response body of the transaction field, if the statuscode is ‘C' or 'S’, the transaction was successful.
If you are using Payrix merchant facility you will see a statuscode of ‘C' (Cleared - Processed by Payrix and debited from Payers account) immediately.
If you are using your own merchant facility, you will typically see a status of 'S' (Settled - Funds settled).
Within the response body of the transaction field, if the statuscode is 'R', the transaction was declined with the rejection reason supplied in the status description.
If a transaction is rejected with a decline reason supplied by the issuer we will return this response. Refer to Transaction Sub-Status Code.
| Info |
|---|
If a transaction is rejected, some decline responses by the card issuer return a generic reason, so it’s not always possible to know exactly why the payment was declined. If all of the information seems correct, it is best to have your customer contact their card issuer and ask for more information. For privacy and security, financial institutions are only obligated to discuss the specifics of a declined payment with their card holder. |
...
Payment Portal example
When a transaction has been processed via a Wallet Payment, our “Transaction Search” tab allows you to specifically search for transactions via a Wallet Payment under “Source” and selecting Apple Pay or Google Pay within the “All Methods” drop down.
...
To determine if the transaction was via a Wallet Payment, if the first 6 digits for the “cardNumber” value are 000000 the payment is deemed to have been paid via Wallet Payment.
...
Q: How to test wallet payments (Apple Pay / Google Pay) in Sandbox
...