2C2P
Verification available
Authenticates the JWT payload. Only an envelope containing payload is accepted; unsigned SoftPOS outer fields are unsupported. merchantID must match configured merchant.
Signature scheme
- Algorithm
- PGW backend JWT HS256
- Signature
- JSON payload field
- Signed data
- JWT encoded header + period + encoded claims
- Encoding
- base64url without padding
- Timestamp
- exp/nbf honored if present; no required event timestamp
Configure verification
Create or edit a source, enable Verify signature and search for 2C2P. The source remains active independently of this switch. Save the provider and its configuration together.
Copy the exact ingress URL from your source when configuring the sender. Save every required field together; saved configuration is encrypted and never returned in source reads.
- merchant id (
merchant_id) (required). - secret key (
secret_key) (required).
For API clients, encode these fields as one JSON object inside the signing_secret string. The dashboard assembles it from the fields above.
Inspect the recorded valid, invalid or not-checked signature result after sending a new event. Changing configuration does not change historical results; replay preserves the original bytes and does not re-sign the webhook.
Capture, delivery and acknowledgement
Verification availability describes the inbound validator. The original incoming query string is not retained or forwarded, and the destination URL or path can differ from the signed request. Acklane does not re-sign deliveries; schemes using that original context may not be verifiable again at the destination.
With async enabled, a failed signature may still be captured and retained, but does not become eligible for signature-on delivery. Replay requires current source eligibility, preserves the event ID and original content, and creates a separate delivery history.
Async capture returns 202 after durable acceptance. A provider that requires HTTP 200 or a special acknowledgement may retry; an implemented validator does not establish compatibility with its acknowledgement rules. No real provider sandbox delivery is certified by this catalog.