Vault Forward card data from a checkout session - mattilda Pay

It is possible to use a Vault Forward directly with a checkout session and Secure Fields. This is especially useful when you don’t want to create a payment method, or when you want to collect a CVV for a payment method.

Forward CVV for a stored card

To forward a security code (CVV) for a stored card, create a checkout session and use it with Secure Fields to collect the security code. More information on this can be found in our Secure Fields guide on this topic. Once you’ve collected the security code, you can forward all the card details using the checkout session as described below.

Forward a checkout session

To forward a checkout session, set the x-vault-forward-checkout-session instead of the x-vault-forward-payment-methods header.

POST /vault-forward
host: api.acme.gr4vy.app
content-type: application/json
x-vault-forward-url: https://example.com/endpoint
x-vault-forward-http-method: PUT
x-vault-forward-header-authorization: Bearer 123
x-vault-forward-checkout-session: b77fef6d-c360-4b42-8f70-d884f4a6852a
x-vault-forward-timeout: 10

{
    "cards": [
        {
            "number": "{{ CARD_NUMBER_1 }}",
            "expiry": "{{ CARD_EXPIRATION_DATE_1 }}",
            "cvv": "{{ CARD_SECURITY_CODE_1 }}"
        }
    ]
}

PUT /endpoint
host: example.com
content-type: application/json
authorization: Bearer 123

{
    "cards": [
        {
            "number": "4111111111111111",
            "expiry": "12/25",
            "cvv": "123"
        }
    ]
}

Please note you can only ever provide one checkout session to vault forward.