Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gr4vy.com/llms.txt

Use this file to discover all available pages before exploring further.

A PSP token is a provider-specific card token issued by a payment service. Unlike a Gr4vy vault token (which is portable), a PSP token is tied to a single provider and can only be used with that provider. Once a card is stored in the vault, you can provision a PSP token for it against any connected payment service.
using Gr4vy;
using Gr4vy.Models.Components;

var sdk = new Gr4vySDK(
    id: "example",
    server: SDKConfig.Server.Sandbox,
    bearerAuthSource: Auth.WithToken(privateKey),
    merchantAccountId: "default"
);

var res = await sdk.PaymentMethods.PaymentServiceTokens.CreateAsync(
    paymentMethodId: "ef9496d8-53a5-4aad-8ca2-00eb68334389",
    paymentServiceTokenCreate: new PaymentServiceTokenCreate() {
        PaymentServiceId = "fffd152a-9532-4087-9a4f-de58754210f0",
        RedirectUrl = "https://example.com/callback",
    }
);

// handle response
The response contains the provisioned token details, including the provider’s token reference.

PSP Tokenization feature guide

Learn more about PSP tokens, when to use them vs network tokens, and how to list and delete them

Next steps

With a card stored in the vault, you can forward it to a third-party endpoint using Vault Forwarding.