Before You Integrate

Complete these steps during technical onboarding. For formal go-live validation with checkboxes, use the Go-Live Checklist in Testing.

Before your first staging payment

Ensure your staging API key is stored in a secrets manager (Sandbox Setup). Point your backend at https://fin-api.digetpay.com/v1, choose an integration path (Choose Integration Path), and define a unique merchantOrderId strategy for each payment attempt.

Include customerPhone in every hosted checkout payment link — it is required for Apple Pay. Configure valid HTTPS successUrl and failureUrl values, deploy a webhook endpoint (Webhook Primer), and confirm dashboard access (Dashboard Overview).

Hosted Checkout validation

Verify that POST /payment/checkout/intiate returns a redirectUrl (note spelling: intiate). Complete a test payment on the Fin checkout page, then confirm status via GET /payment/checkout/status or webhook. Test a small refund (Process Refund).

Ready to implement? See Hosted Checkout Code and Checkout Experience.

Embedded Integration validation

Confirm hash generation matches Request Hash (MD5). Collect card data only via server-side form post — never from browser JavaScript directly to DigetPay. Implement 3DS html response handling, and test capture/void if using auth-only sales.

Ready to implement? See Embedded Integration Code and Embedded Integration Overview.

Before production

Meet Fin Staging Guide pass criteria, then complete the Go-Live Checklist. Obtain a separate production API key, configure production URLs (Production Environment), register production webhooks, and verify Apple Pay domain registration if applicable.

Next steps