Standalone Card Binding
Market: ZA South Africa
Binds a card via a zero-amount authorization without creating a payment transaction. The card binding flow triggers a $0 verification followed by 3DS authentication. On success, the API returns a cardToken that can be reused for subsequent payments.
Typical use cases: MIT (merchant-initiated transaction) recurring billing setup, one-click payment pre-binding, wallet card management.
Request Parameters
Yes = required · No = optional
Response Fields
Example
Request / Response
Notification Callback
Once the card binding flow (including 3DS authentication) is completed, PalmPay sends an asynchronous POST notification to the callback address configured in your Open Platform dashboard.
⚠️ Do not confuse the two URLs:
callBackUrl— where the cardholder's browser is redirected after 3DS (front-end)- Notification callback — a server-to-server call from PalmPay to your backend (asynchronous result push)
Request Format
- Method:
POST - Content-Type:
application/json - Header:
countryCode: ZA
Notification Parameters
Example Payload
Signature Verification
The sign field is generated with the same algorithm as request signing. Verify it using the PalmPay public key:
- URL-decode the
signvalue (it contains%2F=/and%2B=+) - Sort all non-empty parameters except
signby key in ASCII ascending order and concatenate askey=value&key=value - Compute
MD5(strA).toUpperCase()→md5Str - Verify
md5Stragainst the decodedsignusingSHA1WithRSAwith the PalmPay public key
⚠️ Encoding caveat: the
signvalue may contain a mix of URL-encoded characters (%2F,%2B) and raw/. Always use a standard URL decoder (e.g.java.net.URLDecoder.decode) — do not perform manual string replacement.Notifications that fail signature verification must be treated as invalid and discarded.
Retry Policy
If your endpoint does not return the expected success acknowledgement within the timeout, PalmPay will retry the notification automatically according to the configured policy.
Expected Merchant Response
Return the agreed success acknowledgement after processing the notification. Otherwise PalmPay will keep retrying until the maximum attempt count is reached.