Get card information
Description
The GetCardInformation call can be used to retrieve information about the card used for the transaction. It is supported for all cards. Netaxept then returns detailed information concerning the card, such as Issuer country, card type, card country code, card country name and card product type. The GetCardInformation call can be used for example to apply surcharging logic for saved card details when processing subsequent payments. When the customer is about to checkout with the saved card details, merchant can retrieve the detailed information about the given card and based on that assign and display a fee to the subsequent payment.
If the GetCardInformation call is sent after the Register call, but before the Terminal call, Netaxept throws the GenericError with message "No card Information". The GetCardInformation call can be used for cards originally saved in Netaxept. If the card details have been imported from another PSP to Netaxept, retrieving all card details may not be possible.
The input data is organized into a GetCardInfoRequest, and the output data is formatted as a GetCardInfoResponse. Example of the REST GetCardInformation call and the corresponding response can be found in the "Sample code" section.
API call
REST
- Test: https://test.epayment.nets.eu/Netaxept/getcardinformation.aspx
- Production: https://epayment.nets.eu/Netaxept/getcardinformation.aspx
Please note that Server Name Indication (SNI) is required when connecting to Netaxept test environment URL https://test.epayment.nets.eu
Web Services
GetCardInfo (string merchantId, string token, GetCardInfoRequest request) -> GetCardInfoResponse
Input parameters
Available input parameters in the GetCardInformation are listed below. Please see proper validation rules at the “Validation” section.
Authentication (Required)
| Merchant ID | REST: merchantId | WebServices: merchantId |
| Required | Validation: Numeric | MaxLength: 8 |
| Unique ID generated by Nets for identifying each merchant in Netaxept. You need to send this ID to Netaxept along all API calls. Test accounts may have a maximum length of 8 digits, while production accounts has a maximum length of 6 digits. | ||
| Token | REST: token | WebServices: token |
| Required | Validation: Reference | MaxLength: 32 |
| Shared secret between the merchant and Netaxept that is used to authenticate the merchant and is provided to you by Netaxept. | ||
GetCardInfoRequest
At least one of the following parameters needs to be specified: maskedpan, panHash or transactionId.
| Transaction ID | REST: transactionId | WebServices: transactionId |
| Optional | Validation: Reference | MaxLength: 32 |
| Unique ID identifying each transaction within the Merchant ID in Netaxept at any point. Transaction ID used in this call needs to match the Transaction ID used with the Register call. | ||
| Masked PAN | REST: maskedPan | WebServices: maskedPan |
| Optional | Validation: Numeric | MaxLength: 19 |
| First 6 digits (can be entered also more) of the card number used for this transaction. | ||
| PanHash | REST: panHash | WebServices: PanHash |
| Optional | Validation: Base64 | MaxLength: N/A |
| Token value used in subsequent transaction to identify the transaction. It is independent of the PAN and is not considered as a hash value. It is the merchant's responsibility to store tokens in a secure way and restrict access to data on a need to know basis. The merchant undertakes not to store tokens on a frontend system exposed to the internet or directly on mobile devices. | ||
Output parameters
Available output parameters in the GetCardInfoResponse are listed below.
| Issuer | REST: issuer | WebServices: issuer |
| Required | Validation: Alpha | MaxLength: 32 |
| Indicates which payment method was used for the transaction. Please see the valid payment methods at the Register call page, in the "Payment Method Action List" => "PaymentMethod" parameter. | ||
| Card type | REST: cardType | WebServices: cardType |
| Required | Validation: Alpha | MaxLength: N/A |
| Type of the card used for the transaction. Valid values are:
| ||
| Card country code | REST: countryCode | WebServices: countryCode |
| Required | Validation: Numeric | MaxLength: 3 |
| Numeric code for the country where the card used for the transaction was issued, following ISO 3166-1. For example: “246” for Finland and “752” for Sweden. | ||
| Card country name | REST: countryName | WebServices: countryName |
| Required | Validation: Alpha | MaxLength: 2 |
| Country where the card used for the transaction was issued, following ISO 3166-1 Alpha 2 code. For example: "NO", "SE", "DK", "FI". | ||
| Card product type | REST: cardProductType | WebServices: cardProductType |
| Required | Validation: Alpha | MaxLength: N/A |
| Product type of the card used for the transaction. Valid values are:
| ||
| Card origin | REST: cardOrigin | WebServices: cardOrigin |
| Required | Validation: Alpha | MaxLength: N/A |
| Origin of the country where the card used for the transaction was issued. Valid values are:
| ||
| Brand | REST: brand | WebServices: brand |
| Optional | Validation: Alpha | MaxLength: N/A |
| Brand of the card used for the transaction. Returned only if present in the Netaxept BIN file. | ||
Exceptions and response codes
If something goes wrong when communicating between your system and Netaxept or in the middle of the payment process, Netaxept declines the transaction and returns an exception. All exceptions are wrapped in the outer Exception tag, with an Error tag inside. The type (xsi:type) of the Error tag indicates which exception it is. In most cases, the exception includes the error code indicating the error, as well as an error message explaining the code. The GetCardInformation call can throw the following exceptions. Read more about exceptions > and response codes >
- AuthenticationException
- GenericError
- ValidationException