External Tokens
Implement Google Pay and Apple Pay tokens
External Tokenization (also known as Network Tokenization) is a security process used by major card networks like Visa and Mastercard. It replaces a card’s sensitive Primary Account Number (PAN) with a unique, network-issued token. This token is used in transactions instead of the actual card number, reducing the risk of fraud and data breaches. Network tokens are used across multiple payment channels, including traditional card-on-file setups and digital wallets like Apple Pay and Google Pay, enabling safer and more seamless transactions for merchants and users.
Mandatory Parameters
| Parameter Name | Format | Length | Description |
|---|---|---|---|
| ccn | numeric | max. 16 digits | The ccn field contains the customer's credit card number. The payment gateway is capable of processing any credit card type. This field is used for Token |
| exp_year | numeric | 4 digits | Token expiry year. |
| exp_month | numeric | 2 digits | Token expiry month. |
| external_token_type | enum | ("apple-pay", "google-pay", "network") | |
| external_token_cryptogram | Base64-encoded string | The external_token_cryptogram field contains the payment cryptogram generated by the external token service (Apple Pay, Google Pay or network tokenization); it must be transmitted as a valid Base64 string. | |
| external_token_eci | numeric | 2 digits | ECI Value |
ECI value for Google Pay & Apple Pay
Parameter external_token_eci
Visa: 07
MC: Optional
You can use both /payment_authorize or /payment_preauthorize APIs. In the case of /payment_preauthorize you will need to use our capture API in order to have success Capture.
GooglePay Tokens
To initiate a transaction you need to send an authorization request from your server.
Send a request
POST https://sandbox.payabl.com/pay/backoffice/payment_authorize
Request example
merchantid=api_test&amount=1.23¤cy=EUR&orderid=test&language=de&email=aneu%40powerpay21.com&signature=924043247f6d7d943a44e319a101e8522d681b1e&customerip=127.1.1.1&payment_method=1&ccn=4242424242424242&exp_month=01&exp_year=2015&external_token_type=google-pay&external_token_eci=5&external_token_cryptogram=/wAAABYAeXbZJpAAAAAAgIBgE4A=
Response example:
transactionid=213592105&transid=213592105&status=0&errormessage=&errmsg=&
amount=1.23&price=1.23¤cy=USD&orderid=Powercash21-Test&payment_method=1&ccn_four=4242&
card_type=VISA&expiry_month=12&expiry_year=2030&user_id=46929
ApplePay Tokens
To initiate a transaction you need to send an authorization request from your server.
Send a request
POST https://sandbox.payabl.com/pay/backoffice/payment_authorize
Request example
merchantid=api_test&amount=1.23¤cy=EUR&orderid=test&language=de&email=aneu%40powerpay21.com&signature=924043247f6d7d943a44e319a101e8522d681b1e&customerip=127.1.1.1&payment_method=1&ccn=4242424242424242&exp_month=01&exp_year=2015&external_token_type=apple-pay&external_token_eci=5&external_token_cryptogram=/wAAABYAeXbZJpAAAAAAgIBgE4A=
Response example:
transactionid=213592105&transid=213592105&status=0&errormessage=&errmsg=&
amount=1.23&price=1.23¤cy=USD&orderid=Powercash21-Test&payment_method=1&ccn_four=4242&
card_type=VISA&expiry_month=12&expiry_year=2030&user_id=46929
Our Technical Support team is there to help you:
Email: [email protected]
Available Monday – Friday between 09:00 and 17:00 CET/CEST
Updated about 13 hours ago