POST
/
vault-forward
curl --request POST \
  --url https://api.{gr4vy_id}.gr4vy.app/vault-forward \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: */*' \
  --header 'x-vault-forward-http-method: <x-vault-forward-http-method>' \
  --header 'x-vault-forward-payment-methods: <x-vault-forward-payment-methods>' \
  --header 'x-vault-forward-url: <x-vault-forward-url>' \
  --data '"{\n  \"number\":\"{{CARD_NUMBER_1}}\",\n  \"expiry\":\"{{CARD_EXPIRATION_DATE_1}}\"\n}\n"'

This endpoint requires the vault-forwards.write scope.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-vault-forward-payment-methods
string
required

A comma-separated list of Payment Method IDs that can be used to fill in the request template. At least 1 must be given, and a maximum of 100 are accepted.

​
x-vault-forward-authentications
string

A comma-separated list of IDs for the authentication methods that will be applied to a Vault Forward request.

​
x-vault-forward-url
string
required

The URL to forward card data to.

​
x-vault-forward-http-method
enum<string>
required

The HTTP method that is used when forwarding the request to the x-vault-forward-url.

Available options:
POST,
PUT,
PATCH
​
x-vault-forward-header-{HEADER_NAME}
string

A header that is forwarded to the x-vault-forward-url. The header will be forwarded without the x-vault-forward-header part. For example, x-vault-forward-header-x-frame-options: SAMEORIGIN is forwarded as x-frame-options: SAMEORIGIN.

​
x-vault-forward-timeout
integer
default:
30

The number of seconds to wait before timing out when forwarding the request.

Required range: x > 1

Body

*/* · string

The body is of type string.

Response

200 - */*

The response is of type string.

Was this page helpful?

Suggest edits
Delete payment service tokenList endpoints