v1

latestOpenAPI 3.1.0Payrails GmbH2026-07-2614905.7 MB
Vault Proxy Connections

Invoke an outbound proxy connection

Proxies an outbound request to the destination using the provided headers. Please note that you can configure connection using any of HTTP methods, not only POST.

post/token/connections/{connectionId}/proxy

Path parameters

connectionIdstring uuid required

Identifier of the resource in Payrails.

Headers

Payrails-Authorizationstring required
Example:Bearer abc123

The Payrails authorization token generated using the client ID and secret.

Payrails-Destinationstring required

Target endpoint URL.

Example:https://your-partner.com/api/some-api-endpoint

The destination URL to be proxied after being processed by Payrails. Ensure that the domain is whitelisted in the connection settings via the portal.

Response

Returns the response from the destination URL. Although it was demonstrated to return raw data, the raw response is passed to the proxy merchant, which aligns with the real-world use case. In a real scenario, the merchant would not return actual card data — this is just a sample response to demonstrate the proxy use case.