Displaying card data directly on mobile apps is possible with Reveal, which is the mobile version of Show.

Before you start

🚧

Make sure to read Show and Security and Compliance before proceeding.

You can then get started by following this quick start guide.

1. Get a transactionId

Start with requesting a transactionId by calling the Show API from your server.

Example

curl --request POST \
  --url 'https://api.sandbox.datatrans.com/v1/transactions/secureFields/show' \
  --header 'Authorization: Basic {{basicAuth}}' \
  --header 'Content-Type: application/json' \
  --data '{
	"alias": "rN5IABEiAAEAAAGB8QcMWHYu8SeGACOZ",
	"aliasCVV": "qOr2SX3sQm2e8SazhFNssOkJ"
}'

{
  "transactionId": "W0ZcW8zvzQ0DEISV0UafKeT8eFmC"
}

You can send alias or aliasCVV each alone, if you only need to reveal one of those values.

2. Frontend integration

To display the requested card data, call the Reveal endpoint directly from the native mobile application with the transactionId obtained previously.

🚧

The Reveal endpoint is only supported for native mobile applications.

Make sure not to call it from web browsers.

Example

curl --request POST \
  --url 'https://api.sandbox.datatrans.com/v1/transactions/secureFields/show/reveal' \
  --header 'Content-Type: application/json' \
  --data '{
	"transactionId": "W0ZcW8zvzQ0DEISV0UafKeT8eFmC"
}'

{
	"cardNumber": "4242424242424242",
	"cvv": "123"
}