Payment Methods

DigetPay supports multiple payment methods through Hosted Checkout. Customers select an available payment method on the DigetPay checkout page after your application redirects them to redirectUrl.

All card entry, 3-D Secure, and wallet flows are handled by DigetPay, so your server never handles sensitive card data such as PAN or CVV.

📘
Payment methods are selected by the customer on the DigetPay checkout page.

Supported Payment Methods

Payment Method	Customer Experience	Requirements
Card & Mada	Customer enters card details	None
Saved Card	Returning customer selects a previously used card	Consistent `customerEmail`
Apple Pay	Native Apple Pay sheet or desktop QR flow	`customerPhone` must be sent when creating the payment link

flowchart TD
  Checkout[DigetPay Checkout] --> Card[Card / Mada]
  Checkout --> Saved[Saved Card]
  Checkout --> ApplePay[Apple Pay]

  ApplePay --> Safari[Safari / Apple Pay Sheet]
  ApplePay --> QR[Desktop QR Flow]

Card & Mada

The customer enters their card details directly on the DigetPay hosted payment page.

Visa, Mastercard, Mada, and other available supported card methods can be displayed.
The customer enters their card number, expiry date, CVV, and name.
3-D Secure authentication is requested when required by the card issuer.
Your application does not receive or process the customer's card details.

3-D Secure is handled during the payment flow when required by the issuing bank.

Security benefit: Card entry and 3-D Secure authentication are handled on DigetPay infrastructure.

Saved Cards

Returning customers may see previously used cards when DigetPay can recognize the customer from the payment information provided during payment creation.

To support customer recognition, send a consistent:

customerEmail

Saved cards are displayed and selected on the DigetPay checkout page. The customer's full card details are not returned to your application.

📘
Saved card availability depends on whether the customer has previously completed a supported payment and can be recognized by the checkout flow.

Apple Pay

Apple Pay is available through DigetPay Hosted Checkout on supported devices and browsers.

Requirement	Details
Phone	Send `customerPhone` when creating the payment link
Safari	Native Apple Pay experience on supported Apple devices
Desktop Chrome	Customers can continue through the supported QR flow
Merchant code	No additional Apple Pay integration code is required for Hosted Checkout

🚧
Apple Pay not showing? Verify that customerPhone was included in the Create Payment Link request and that the customer is using a supported device or browser.

For additional details, see Apple Pay on Hosted Checkout.

Create Payment Link Example

Include customer information when creating the payment link:

{
  "merchantOrderId": "ORD-1001",
  "amount": 10.00,
  "currency": "SAR",
  "customerName": "Ahmed Ali",
  "customerEmail": "[email protected]",
  "customerPhone": "501223324",
  "successUrl": "https://yourstore.com/checkout/success",
  "failureUrl": "https://yourstore.com/checkout/failure"
}

Use:

POST /payment/checkout/intiate

with the appropriate environment:

Environment	API Base URL
Fin Staging	`https://fin-api.digetpay.com/v1`
Production	`https://api.digetpay.com/v1`

❗️
Always verify the final payment result using the Transaction Status API or a webhook. A redirect to successUrl does not by itself confirm that the payment was successful.

Payment Method Availability

The payment methods displayed to the customer may depend on the checkout environment, customer device or browser, transaction details, and merchant configuration.

For example:

Apple Pay is displayed only when the customer is using a supported device or browser and the required payment data is provided.
3-D Secure is triggered when required by the issuing bank or payment network.
Saved Cards may be available for recognized returning customers.

Integration Responsibilities

Your Application	DigetPay
Create the payment link	Render the checkout page
Provide customer information	Collect card details
Redirect the customer to `redirectUrl`	Process supported payment methods
Handle return URLs	Handle 3-D Secure
Verify the final payment result	Handle Apple Pay
Fulfill the order after verification	Return the customer to your success or failure URL

Payment Methods

Supported Payment Methods

Card & Mada

Saved Cards

Apple Pay

Create Payment Link Example

Payment Method Availability

Integration Responsibilities

Related Documentation