PUSH Method

This service requires IP whitelisting of the requesting 3rd party. Please contact the PCI Proxy team to add the IPs to your account.

Process flow

Push method allows you to receive a request via PCI Proxy on a uniquePushKey endpoint. Your partners can push requests to this unique PCI Proxy endpoint to ask for credit card data in the response. Hence, it is routed via PCI Proxy, your response payload is instantly filtered for tokens, all tokens will be detokenized and your response payload is populated with sensitive card data before it arrives at the Receiver. All other headers and payload will be kept and routed through PCI Proxy without modification.

Process Flow with PCI Proxy

post
PUSH method - API request

https://sandbox.pci-proxy.com/v1/push/uniquePushKey
Request
Response
Request
Path Parameters
uniquePushKey
required
string
Your uniquePushKey can be accessed by clicking in the Settings of the Integration you added in the dashboard.
Response
200: OK
Response depends on your API.
<!-- your response - tokens will be detokenized and card data forwarded -->

In test mode, only test credit cards are allowed.

Example

When you add a PUSH Receiver to your account, you receive a {uniquePushKey} for each Receiver that is set up. Together with our PCI Proxy PUSH service URL, it results in a unique PCI Proxy Endpoint that is specific to that Receiver. Now, redirect requests coming from a Receiver with a single step:

  1. Change endpoint at Receiver from Your API Endpoint to unique PCI Proxy Endpoint

If needed, whitelist IP addresses of PCI Proxy at Receiver.

As the request is routed via PCI Proxy, the response payload is automatically filtered for tokens. Located tokens are detokenized and your response payload is populated with full card data before it arrives at the Receiver endpoint. Thereby, the Receiver API endpoint obtains full credit card data.