Guides

Integration guides for WinkPG: how the pieces fit together, what to send, and what comes back. Each one is written for a developer, so it carries requests and payloads rather than walkthroughs of the administration screens.

The guides aren't available right now

This instance couldn't load its guide catalog, so this page lists nothing. The guides return as soon as the catalog is readable again.

This instance publishes no developer guides.

Concepts

How timezones are handled The UTC storage model, the display conversion boundary, and the timezone policy applied to API payloads, exports, and generated documents.

Integration

Getting started with the API Find the API reference, create an API key, authenticate your first call, and handle idempotency, rate limits, and timestamps correctly.
Rate limits and your allowance See the limits that apply to your API keys, watch how much allowance is left, find the calls that were refused, and back off correctly when you run out.
API key expiration reminders How WinkPG warns a key's owner ahead of API key expiry, and how to route those warnings to email, a webhook, or another channel your team reads.
Webhook integration Receive, verify, and deduplicate WinkPG platform events at your own HTTPS endpoint.
Reusing a stored payment method with payment tokens Capture the reusable payment token returned when a card is saved, then charge the stored card again without handling card data, declaring whether the customer is present for each charge.
Storing a card for a wallet Store a card without charging it by creating a save-only session from your server, mounting it, and binding the resulting payment token on the card-saved webhook rather than on what the browser reports.
Sharing payment tokens across merchants Let merchants under one reseller charge each other's stored payment tokens, and learn which handle, which credential, and which consent that takes.
Hosted payment page iframe integration Embed the Hosted Payment Page in an iframe and communicate over the postMessage lifecycle protocol.
Processor routing and failover How WinkPG picks a processor for each transaction, when it retries on a second one, and how to read the routing decision for a sandbox transaction.
Sandbox test cards One scenario per sandbox classification test card, with the request to send, the classification to expect on the response, and the behavior each card lets you observe.
The embedded payments SDK Mount the hosted payment form inside your own page with the browser loader: options, events, session lifecycle, script pinning, and Content Security Policy.
Embedded payments compared with in-page card collection How a gateway-hosted embedded payment form differs from a direct card-collection script, and what changes for your servers when you move.

Payments

Transaction lifecycle and settlement What authorized, captured, and settled mean, when the money actually moves, and which undo operation to use.
Understanding declines and rejections How to read a refused payment: the three result fields, the refusal families, which ones leave a hold, what you can retry, and what to tell the payer.
ACH payments How a bank debit clears, where to take one, and how to read its status from submission through settlement or return.
Refunds, voids, and reversals Undo a payment over the API: which of the three operations applies, how partial amounts work, and the error codes to branch on.
Transaction custom fields Define your own fields, collect them on a payment page or through the API, and carry them on the transaction record.

Quickstart

Quickstart: Direct API Authenticate with an API key and take your first card payment over the WinkPG API.
Quickstart: Hosted payment page Create a hosted page, open a session for one payment, and send the payer to it without card data touching your server.
Quickstart: Embedded payments SDK Mount the WinkPG payment form inside your own checkout page with the browser loader.
Quickstart: Webhooks Stand up an endpoint that verifies a WinkPG delivery signature, register it, and receive your first event.