Apple Pay Testing

Validate Apple Pay before production using the Fin staging environment. Test both hosted checkout (zero code) and embedded integration (your Apple Pay button) paths.

📘
Staging API: https://fin-api.digetpay.com/v1. Use your Fin staging x-api-key — never production keys in staging.

🚧
Apple Pay in staging requires a test card in Apple Wallet and a compatible device (iPhone/iPad/Mac with Safari).

❗️
Do not use production merchant IDs or production domains in Fin staging tests.

Test matrix

flowchart TD
  Start[Apple Pay test plan] --> HC[Hosted checkout]
  Start --> EI[Embedded integration]
  HC --> Safari[Safari iOS — native sheet]
  HC --> QR[Chrome desktop — QR scan]
  EI --> Domain[Domain verification]
  EI --> Token[Token → embedded sale API]

Scenario	Path	Expected result
Safari on iPhone	Hosted	Apple Pay button → native sheet → success
Chrome on desktop	Hosted	QR code → scan → iPhone Safari → success
Your checkout + Apple Pay JS	Embedded	Merchant validation → token → sale API
Missing `customerPhone`	Hosted	No Apple Pay button

Hosted checkout validation

Create a payment link via POST /payment/checkout/intiate with customerPhone, then open redirectUrl in Safari on iPhone. Confirm the Apple Pay button is visible, complete payment with a test Wallet card, and verify via status API or webhook — not redirect alone. Test the Chrome desktop QR flow (Desktop QR).

Code: Hosted Checkout Code (PHP)

Embedded integration validation

Confirm the domain association file is accessible at /.well-known/, the Apple Pay button appears in Safari on your checkout page, merchant validation succeeds, and the token is posted to your server (not directly to DigetPay). Verify the embedded sale API returns APPROVED or 3DS html, and that webhooks update order status.

Code: Apple Pay Code (PHP)

Staging URLs

Setting	Value
API base	`https://fin-api.digetpay.com/v1`
Success URL (Fin)	`https://fin-admin.digetpay.com/pay/checkout/success`
Failure URL (Fin)	`https://fin-admin.digetpay.com/pay/checkout/failure`

Testing Guide → | Go-Live Checklist →

Common failures

Symptom	Likely cause
No Apple Pay button (hosted)	Missing `customerPhone` at link creation
No Apple Pay button (embedded)	Domain not verified or not Safari
Merchant validation fails	Certificate misconfigured
Sale API rejects token	Token mapping — contact DigetPay support