---
title: "Execute an instant proxy request"
method: POST
path: "/payment/providers/{providerId}/proxy"
tags: ["Vault Instant Proxy"]
---

# Execute an instant proxy request

`POST /payment/providers/{providerId}/proxy`

Executes a proxy request from our Vault to an external provider.

## Path parameters

- `providerId` string, uuid, required

## Headers

- `x-idempotency-key` string, uuid, required
- `Accept` string, required
- `Content-Type` string, required
- `Authorization` string

## Request body

- object
  - `paymentInstrumentId` string, uuid, required — Payment Instrument that should be used.
  - `headers` object, required — Headers that should be used for the request to the provider. The "Content-Type" header is required and must be passed exactly once.
  - `url` string, uri, required — URL address of the payment provider server to be called.
  - `body` object, required — Body that should be used for the request to the provider.
  - `encryptedSecurityCode` string — Encrypted instrument security code replacing the security code from an earlier tokenization (if any). The instrument security code should be encrypted with the RSA public key provided by Payrails SDK using JWE with encryption algorithm RSA-OAEP-256 and content encryption A256CBC-HS512.
  - `preProcessors` object[] — Array of processors used when you need Payrails to make a customization in the request before forwarding it to the downstream destination, i.e. calculating a signature of body including sensitive data.
    - `code` string — Representation of a certain pre or post processor in Payrails.
    - `parameters` object — Parameters required for a certain pre or post processor in Payrails, refer to API guides for parameters of a specific processor.
  - `postProcessors` object[] — Array of processors used when you need Payrails to make a customization in the response of the downstream destination before forwarding it to your system. i.e. redact any sensitive information in the response from a payment processor.
    - `code` string — Representation of a certain pre or post processor in Payrails.
    - `parameters` object — Parameters required for a certain pre or post processor in Payrails, refer to API guides for parameters of a specific processor.

## Response `200`

Executed.

- object
  - `status` integer, required — HTTP status that was returned by the provider.
  - `headers` object — Headers that were returned by the provider.
  - `body` object — Body that was returned by the provider.

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized.
- `403` — Insufficient Scope.
- `404` — Not Found.
- `429` — Too Many Requests.

---

[API](https://skmtc.net/payrails/apis/payrails-api-reference.md) · [All operations](https://skmtc.net/payrails/apis/payrails-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payrails/payrails-api-reference/revisions/9dd2f0158582/schema)