PUT - Proxy

You can use this method to send a request that use sensitive data in the body with the replaced values of the token.

cUrl

PUT /
curl -X PUT https://api.firstoken.co/proxy/
-H 'ft-access-key: YOUR_ACCESS_KEY'
-H "Content-Type: application/json"

Headers of the request

• ft-url-destiny: string

  URL which proxy API will send the request

  Required: true

• ft-access-key: string This headers contains the Firstoken API Key Required: true

• ft-headers: JSON

  This JSON contains the headers that proxy have to add to the request.

  Example: "{Authorization" : "Basic VHR4NnBmRGd6OEJLdDNaQTNVR3pzUGR0WnpJOjRReEdONDRRQWVSRXB5d2lsOGR2NEFIY1ZSNWZ2SUJkbm9PTmNqRDE0NHc0V21sUzFJRktaeUduNGJOSkI2TFU=}"

  Required: false

• ft-encryption: JSON

  This JSON contains the properties required to apply an encryption in the selected values.

  Must contain the following properties:

  • Key: string

    Is the RSA key,

  • Type: string

    The type of the encryption algorithm.

  • is_partial: Boolean

    Explains if the encryption is partial or not.

  Example: {"key": "{{your-encryption-key}}", "type": "RSA", "is_partial": true}

  Required: false

Request Body

In the Proxy body, only a valid token (permanent or temporary) is necessary to extract sensitive data with the actions and filters explained in "Actions".

Example body of a Proxy PUT request

{
    "chd": {
        "card": " {{ca3a512d-f358-4c20-8057-aafa6ae5b45c:transaction | extract:card}}",
        "name": " {{ca3a512d-f358-4c20-8057-aafa6ae5b45c:transaction | extract:name}}",
        "exp": " {{ca3a512d-f358-4c20-8057-aafa6ae5b45c:transaction| extract:expiration | date:MM}}/ {{4242428XsEs24242:detokenize | extract:expiration | date:YY}}",
        "cvv": " {{ca3a512d-f358-4c20-8057-aafa6ae5b45c:transaction | extract:cvv | encrypt}}"
    },
    "order": {
        "order_id": "1243092185268",
        "transaction_id": "838CF75C85374DDE88FBF95859D5067E",
        "payment_id": "1E48107A6DAF47C393BA4A40F8BB64EC",
        "reference": "503423",
        "shopper_interaction": "ecommerce",
        "total": "22.33",
        "currency": “USD”,
        "payment_method": "Visa",
        "installments": 2
    }
}

Proxy response body

The Proxy response body will contain the status codes of the call and inside the data object, the response sent by the destination url designated in the header.