# Wallet token decryption API

This API enables you to decrypt Apple Pay and Google Pay payment tokens on your backend systems. The decryption service processes encrypted wallet tokens and returns the decrypted payment data, including card details, cryptograms, and authentication information necessary for transaction processing.

## Use cases

You may want to decrypt wallet token payloads for several reasons:

- **Transaction processing**: Extract the payment account number (PAN/DPAN) and cryptogram required to authorise transactions through payment processors.
- **Fraud detection and risk assessment**: Access device identifiers, authentication data, and assurance details to perform custom fraud screening and risk analysis.
- **Compliance and audit requirements**: Retrieve transaction amounts, currency codes, and authentication responses for regulatory reporting and record-keeping.
- **Custom payment workflows**: Implement specialised payment logic, such as split payments, conditional routing, or multi-step authorisation processes.
- **Token vault integration**: Store decrypted payment credentials in a secure token vault for recurring payments or subscription management.
- **3D Secure processing**: Access cryptograms and ECI indicators for transactions requiring additional authentication steps.

Version: 1.0.0

## Servers

Production environment
```
https://api-services.pxp.io/api/v1
```

Sandbox environment
```
https://api-services.test.pxp.io/api/v1
```

## Download OpenAPI description

[Wallet token decryption API](https://developer.pxp.io/_bundle/apis/wallets.yaml)

## Other

### Decrypt a wallet payment token

 - [POST /wallets/{wallet}/decrypt-token](https://developer.pxp.io/apis/wallets/other/decrypt-wallet-token.md): Decrypts an encrypted payment token from Apple Pay or Google Pay. This endpoint allows you to process wallet payment tokens on your backend, extracting the necessary payment and authentication data required for transaction authorisation. The decryption process validates the token integrity and returns structured payment information specific to the wallet provider.