Digital Wallet – Apple Pay / Google Pay

Hosted Payment Form (Digital Wallet – Apple Pay / Google Pay)

This guide explains how to use Digital Wallets (Apple Pay / Google Pay) on Datman’s Hosted Payment Form.
The transaction flow, encryption, and payload formation remain the same as a normal Sale request.

⚠️ Keys and values are case-sensitive. Incorrect formatting may cause transaction failure.

Prerequisites (Apple Pay)

Before testing Apple Pay, ensure:

Create an Apple Sandbox Tester Account

Add Test Cards inside the Apple sandbox account

Device/browser must support Apple Pay

At least one Apple Pay card must be added to the device wallet

💡 Apple Pay button will only appear on the hosted form if the user’s device:
Supports Apple Pay
Has a valid card added in Apple Wallet

For setup steps, refer to Apple’s sandbox guide.
https://developer.apple.com/apple-pay/sandbox-testing

Prerequisites (Google Pay)

Supported browser/device required

Test cards must be configured in Google Pay test environment

Important Note

Digital Wallet payments use the same Sale API structure.
No change is required in payload formation logic.

You only need to:

Use the same encrypted payload approach

Process Flow Diagram (Digital Wallet)

Environments

Environment	Base URL
Sandbox	`https://sandbox-payments-{{account_name}}.datmanpay.com`
Production	`https://payments-{{account_name}}.datmanpay.com`

Integration Guide

1. Payload Preparation

Use the exact same payload as Sale API.

No additional wallet-specific keys are required.

Wallet selection happens on the hosted page UI, not in the API payload.

2. Wallet Payment Experience

Once redirected:

Hosted form displays Apple Pay / Google Pay options (if supported)

User authorizes payment via wallet

Datman processes the Sale transaction

Response Handling

Scenario	Behaviour
Success	User redirected to `redirect_url`
Cancel	User redirected to `cancel_url`
Final Status	Sent via Webhook (source of truth)

Error Handling

Error	Cause	Action
Wallet Not Showing	Device or browser unsupported	Use compatible device/browser
Unable to process	Missing required Sale keys	Validate payload
Invalid secret	Encryption issue	Check secret length & IV

Security Best Practices

Never expose secret key on frontend

Always validate webhook signature

Use HTTPS for all URLs

Store order_id for reconciliation

Final Notes

Wallet payments are still Sale transactions

No payload change required

Webhook response must always be treated as final payment status

Digital Wallet – Apple Pay / Google Pay

Hosted Payment Form (Digital Wallet – Apple Pay / Google Pay)#

Prerequisites (Apple Pay)#

Prerequisites (Google Pay)#

Important Note#

Process Flow Diagram (Digital Wallet)#

Environments#

Integration Guide#

1. Payload Preparation#

2. Wallet Payment Experience#

Response Handling#

Error Handling#

Security Best Practices#

Final Notes#