This section will guide you through the process of accepting payments using Apple Pay on your website.
Before you start accepting Apple Pay, make sure you complete these steps first:
The current up-to-date version of the library is 1.12.0 which can be used through the official Moyasar CDN server:
You can start the integration by including the previous URLs in the head section of your website as follows:
Once you decide on a good place for the form, add an empty <div> tag and then invoke the init method on our global Moyasar class.
Amount intended to be collected by this payment. A positive integer represents how much to charge in the smallest currency unit (e.g., 100 Halala to charge 1.00 SAR or 100 to charge ¥100, a zero-decimal currency). The minimum amount is 1 SAR or equivalent in charge currency.
3-letter ISO code for currency. E.g., SAR, CAD,
An arbitrary string that you can attach to a payment object. Payment description is only for your reference and it is NOT displayed to users.
Your publishable API key, learn more on how to get the key here.
This optional configuration option is used to set accepted card networks, in the form. The default value is all networks except amex.
This is used to enable and disable payment methods on the form. By default, all the methods are enabled(creditcard, applepay, stcpay).
Learn more about available configuration keys here Form Configuration
For Apple Pay Button to show, the following requirements must be met:
- Safari Browser
- HTTPS Connection
- You're in a country that supports Apple pay, learn more here
- The user clicks on the Apple Pay button.
- The user verifies their identity with Apple Pay using Touch ID or Face ID.
- Payment details are sent securely to Moyasar servers and then processed.
This step is optional but highly recommended to save the payment ID before displaying the user, which grants you the ability to verify payment details in case your user's connection drops.
To save the payment ID after the transaction finishes you can provide the on_completed configuration option with a URL, or a callback function.
When providing a URL the library will make a POST request containing the payment object, here is an example:
The URL can be anything you choose.
To verify if the payment has been completed, use our Webhooks to receive an alert when the payment is paid.