How It Works
The UPG provides a unified request structure that is the same regardless of which PSP you are processing with. You send one standard request with a card token, amount, currency, and your PSP credentials. PCI Booking handles everything from there: it detokenizes the card, constructs whatever API calls the specific PSP requires, and returns a standardized response in a consistent format regardless of which PSP processed the transaction.- You send a standard request to the UPG endpoint with the card token, transaction details, and PSP credentials.
- PCI Booking detokenizes the card, replacing the token with real card data.
- PCI Booking translates your request into the PSP-specific format and sends all necessary API calls to complete the operation.
- PCI Booking normalizes the PSP’s response into a standardized format and returns it to you.
Providing PSP Credentials
You can provide your PSP credentials in two ways:- Inline. Include the PSP name and credential key-value pairs directly in the request body. Useful for testing or when credentials vary per transaction.
- Stored credentials. Pre-save your PSP credentials via PSP Credentials and pass a
credentialsIdquery parameter. Recommended for production use.
Supported Operations
The Tokenize operation does not trigger any charge, and the card remains stored in PCI Booking as well - if you no longer need the PCI Booking token after gateway tokenization, consider deleting it.
Testing in Sandbox
In a sandbox account, the UPG asks each PSP for its test environment where the PSP has one. Some PSPs decide from your credentials alone, so live credentials can process real payments even from a sandbox account. To test the flow without any PSP account, use PCI Booking’s built-in test gateways. See Testing and Going Live.Transaction Result Statuses
Every UPG operation returns one of these result statuses:
A request that takes longer than 29 seconds returns HTTP
504 with an unknown outcome. See Timeouts.
3D Secure and the UPG
You don’t need to do anything special to use 3DS with the UPG. If a token has stored 3DS authentication data (from the hosted card form,store-3d-token, or an in-transit tokenization - see 3DS Auth Management) and the PSP integration you’re routing to supports receiving it, PCI Booking includes that 3DS data in the charge request automatically.
Not every PSP integration supports receiving 3DS data - check Gateway-Specific Guidance for your PSP.
Cardholder Name
The cardholder name on a token is sent to the PSP exactly as it was captured - PCI Booking does not reformat, split, or otherwise adjust it. If your PSP has specific requirements for the name (e.g. separate first/last name fields, a minimum length, or a particular character set), make sure those requirements are satisfied at capture time, not at charge time - there’s no way to correct the name later without a new token.Supported PSPs
See the full list of supported PSPs on our website, or query Get Payment Gateways for the definitive, programmatic list along with each gateway’s capability flags (3DS, gateway tokenization, network tokenization, partial refund support) and required credential fields. If your PSP is not listed, we can add it. Contact support@pcibooking.net with:- Your PCI Booking username.
- The name of the PSP.
- A link to the PSP’s API documentation. The documentation must answer three questions:
- Does the PSP have a server-to-server API call that accepts card details for payment processing?
- Does the PSP support 3D Secure?
- Does the PSP accept a 3D Secure result from an external MPI, or must it run 3D Secure itself?
- A technical support contact at the PSP.
- A test account. Either tell us to sign up for one directly with the PSP, or get one from the PSP and send us the details.
If your PSP requires whitelisting the origin of incoming requests, see Outbound IP Addresses.
Key Benefits
- One endpoint, every supported PSP. The same API call works for Stripe, Adyen, Worldpay, and any other supported PSP.
- Zero PCI scope. Card data never passes through your infrastructure.
- PSP portability. Switch processors by changing your gateway credentials ID, not your integration code.
- Consistent interface. PCI Booking normalizes request and response formats across all PSPs.
Next Steps
Charge
Process a simple charge transaction.
Authorize & Capture
Split authorization and capture into two steps.
PSP Credentials
Set up and manage your PSP credentials.
Gateway-Specific Guidance
PSP-specific requirements and configuration.

