This feature is only available to merchants on the Growth and Advanced Cloud Vault plans. Please reach out to our support team to get set up for network tokenization.

Provision a network token

Once a payment method has been stored, it can be converted into a network token for Visa and Mastercard cards. To do this, we will need to set up your network token requester IDs, after which you can call the provisioning API to create a network token.

curl -i -X POST "https://api.vault.gr4vy.app/payment-methods/{payment_method_id}/network-tokens
" \
    -H "Authorization: Bearer [JWT_TOKEN]" \
    -H "Content-Type: application/json" \
    -d '{
            "merchant_initiated": false
        }'
    

The resulting response includes the network token provisioned by the schemes.

{
  "id": "d6ad71d5-6908-45d6-ab65-39c55475dd08",
  "type": "network-token",
  "payment_method_id": "9bdc4bc4-005e-4658-8eee-a309fc43cd4d",
  "status": "active",
  "token": "...",
  "expiration_date": "01/30",
  "created_at": "2021-01-01T12:34:00.000+00:00",
  "updated_at": "2021-01-01T12:34:00.000+00:00"
}

For more details on provisioning network tokens, including using cryptograms, please see our API reference and extended network token guides.