logo Sogenactif

Release 24.3

go directly to content

Search by keywords

getCardData

To search in the page use Ctrl+F on your keyboard

This function allows consulting of the card information associated with a card number or a card IIN.

If the card number or the card IIN does not exist, a 05 response code is returned. If the request works, 00 response code is returned as well as information related to the card.

Recommended interfaceVersion: PMR_WS_2.55

  • PROD
    https://office-server.sogenactif.com/rs-services/v2/paymentMeanInfo/getCardData
    method
    POST
  • TEST
    https://office-server-sogenactif.test.sips-services.com/rs-services/v2/paymentMeanInfo/getCardData
    method
    POST
  • PROD
    https://office-server.sogenactif.com/services/v2/paymentMeanInfo?wsdl
    method
    POST
  • TEST
    https://office-server-sogenactif.test.sips-services.com/services/v2/paymentMeanInfo?wsdl
    method
    POST

Required

Optional

Request sample

            {
  "cardNumber": "4975000000000000",
  "interfaceVersion": "PMR_WS_2.5",
  "keyVersion": "1",
  "merchantId": "011223344550000",
  "seal": "97fccfbfde4570019236f31e3bb521be477bbc7bf7cf09c30f8fbc3a635a3011"
}

        
                  <urn:getCardData>
         <urn:input>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:interfaceVersion>PMR_WS_2.5</urn:interfaceVersion>
            <urn:cardNumber>4975000000000000</urn:cardNumber>
         </urn:input>
      </urn:getCardData>

        

Required

  • seal
    presence
    Required
    Interface version
    2.5

    Message seal used to ensure the integrity of the request and the authentication of sender / receiver of the message.

Optional

  • cardDataList
    presence
    Optional
    Interface version
    2.5

    CardData container list returned following a card information request (in case of card cobadged several occurrences may appear - example: CB / Visa card).

    Contains
    • cardData
      presence
      Optional
      Interface version
      2.5

      Contains specific information regarding a card

      Contains
      • cardBrand
        presence
        Optional
        Interface version
        2.5

        Please see “paymentMeanBrand”.

      • cardCorporateIndicator
        presence
        Optional
        Interface version
        2.5

        Indicates whether the card is an Enterprise / Commercial card or not.

        List of values
        Empty
        Unknown
        N
        The card is not a corporate card
        Y
        The card is a corporate card
      • cardEffectiveDateIndicator
        presence
        Optional
        Interface version
        2.5

        Indicator of existence of a card effective date (Y/N/Empty)

      • cardProductCode
        presence
        Optional
        Interface version
        2.5

        Product code of the card.

      • cardProductName
        presence
        Optional
        Interface version
        2.5

        Product name of the card.

      • cardProductProfile
        presence
        Optional
        Interface version
        2.5

        Profile code of the card.

        List of values
        C
        Credit (pay after)
        D
        Debit (pay now)
        Empty
        Unknown
        H
        Charge card (UK specific)
        N
        Non-Mastercard
        P
        Prepaid
        R
        Deffered debit
        U
        Universal
      • cardProductUsageLabel
        presence
        Optional
        Interface version
        2.45

        Profile name of the card which is displayed on payment electronic ticket in accordance with MPADS requirements.

        List of values
        COMMERCIAL
        Business card
        CREDIT
        Credit card
        DEBIT
        Debit card
        PREPAID
        Prepaid card
      • cardScheme
        presence
        Optional
        Interface version
        2.5

        Network name associated with the card.

        List of values
        ACCORD
        Accord scheme
        AMEX
        American Express scheme
        BCMC
        Bancontact scheme
        CB
        Bank Card scheme
        MASTERCARD
        Mastercard scheme (Example of cards on the Mastercard scheme: Mastercard, Maestro)
        SOFINCO
        Sofinco scheme
        VISA
        Visa scheme (Example of cards on the Visa scheme: Visa, Vpay, Visa Electron)
      • cardSeqNumberIndicator
        presence
        Optional
        Interface version
        2.5

        Indicator of existence of an issue number

        List of values
        1
        Card issue number of length 1
        2
        Card issue number of length 2
        3
        Card issue number of length 3
        Empty
        Unknown
        N
        No card issue number
      • issuerCode
        presence
        Optional
        Interface version
        2.5

        Issuer code of the card. This data is called cardIssuerCode in the reports.

      • issuerCountryCode
        presence
        Optional
        Interface version
        2.5

        Country code of the card issuer. This data is called cardIssuerCountryCode in the reports.

        List of values
        ABW
        ARUBA
        AFG
        AFGHANISTAN
        AGO
        ANGOLA
        AIA
        ANGUILLA
        ALA
        ÅLAND ISLANDS
        ALB
        ALBANIA
        AND
        ANDORRA
        ARE
        UNITED ARAB EMIRATES
        ARG
        ARGENTINA
        ARM
        ARMENIA
        ASM
        AMERICAN SAMOA
        ATA
        ANTARCTICA
        ATF
        FRENCH SOUTHERN TERRITORIES
        ATG
        ANTIGUA AND BARBUDA
        AUS
        AUSTRALIA
        AUT
        AUSTRIA
        AZE
        AZERBAIJAN
        BDI
        BURUNDI
        BEL
        BELGIUM
        BEN
        BENIN
        BES
        BONAIRE, SINT EUSTATIUS AND SABA
        BFA
        BURKINA FASO
        BGD
        BANGLADESH
        BGR
        BULGARIA
        BHR
        BAHRAIN
        BHS
        BAHAMAS
        BIH
        BOSNIA AND HERZEGOVINA
        BLM
        SAINT KITTS AND NEVIS
        BLR
        BELARUS
        BLZ
        BELIZE
        BMU
        BERMUDA
        BOL
        BOLIVIA, PLURINATIONAL STATE OF
        BRA
        BRAZIL
        BRB
        BARBADOS
        BRN
        BRUNEI DARUSSALAM
        BTN
        BHUTAN
        BVT
        BOUVET ISLAND
        BWA
        BOTSWANA
        CAF
        CENTRAL AFRICAN REPUBLIC
        CAN
        CANADA
        CCK
        COCOS (KEELING) ISLANDS
        CHE
        SWITZERLAND
        CHL
        CHILE
        CHN
        CHINA
        CIV
        CÔTE D’IVOIRE
        CMR
        CAMEROON
        COD
        CONGO, THE DEMOCRATIC REPUBLIC OF THE
        COG
        CONGO
        COK
        COOK ISLANDS
        COL
        COLOMBIA
        COM
        COMOROS
        CPV
        CAPE VERDE
        CRI
        COSTA RICA
        CUB
        CUBA
        CUW
        CURAÇAO
        CXR
        CHRISTMAS ISLAND
        CYM
        CAYMAN ISLANDS
        CYP
        CYPRUS
        CZE
        CZECH REPUBLIC
        DEU
        GERMANY
        DJI
        DJIBOUTI
        DMA
        DOMINICA
        DNK
        DENMARK
        DOM
        DOMINICAN REPUBLIC
        DZA
        ALGERIA
        ECU
        ECUADOR
        EGY
        EGYPT
        ERI
        ERITREA
        ESH
        WESTERN SAHARA
        ESP
        SPAIN
        EST
        ESTONIA
        ETH
        ETHIOPIA
        FIN
        FINLAND
        FJI
        FIJI
        FLK
        FALKLAND ISLANDS (MALVINAS)
        FRA
        FRANCE
        FRO
        FAROE ISLANDS
        FSM
        MICRONESIA, FEDERATED STATES OF
        GAB
        GABON
        GBR
        UNITED KINGDOM
        GEO
        GEORGIA
        GGY
        GUERNSEY
        GHA
        GHANA
        GIB
        GIBRALTAR
        GIN
        GUINEA
        GLP
        GUADELOUPE
        GMB
        GAMBIA
        GNB
        GUINEA-BISSAU
        GNQ
        EQUATORIAL GUINEA
        GRC
        GREECE
        GRD
        GRENADA
        GRL
        GREENLAND
        GTM
        GUATEMALA
        GUF
        FRENCH GUIANA
        GUM
        GUAM
        GUY
        GUYANA
        HKG
        HONG KONG
        HMD
        HEARD ISLAND AND MCDONALD ISLANDS
        HND
        HONDURAS
        HRV
        CROATIA
        HTI
        HAITI
        HUN
        HUNGARY
        IDN
        INDONESIA
        IMN
        ISLE OF MAN
        IND
        INDIA
        IOT
        BRITISH INDIAN OCEAN TERRITORY
        IRL
        IRELAND
        IRN
        IRAN, ISLAMIC REPUBLIC OF
        IRQ
        IRAQ
        ISL
        ICELAND
        ISR
        ISRAEL
        ITA
        ITALY
        JAM
        JAMAICA
        JEY
        JERSEY
        JOR
        JORDAN
        JPN
        JAPAN
        KAZ
        KAZAKHSTAN
        KEN
        KENYA
        KGZ
        KYRGYZSTAN
        KHM
        CAMBODIA
        KIR
        KIRIBATI
        KNA
        SAINT BARTHÉLEMY
        KOR
        KOREA, REPUBLIC OF
        KWT
        KUWAIT
        LAO
        LAO PEOPLE’S DEMOCRATIC REPUBLIC
        LBN
        LEBANON
        LBR
        LIBERIA
        LBY
        LIBYA
        LCA
        SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
        LIE
        LIECHTENSTEIN
        LKA
        SRI LANKA
        LSO
        LESOTHO
        LTU
        LITHUANIA
        LUX
        LUXEMBOURG
        LVA
        LATVIA
        MAC
        MACAO
        MAF
        SAINT MARTIN (FRENCH PART)
        MAR
        MOROCCO
        MCO
        MONACO
        MDA
        MOLDOVA, REPUBLIC OF
        MDG
        MADAGASCAR
        MDV
        MALDIVES
        MEX
        MEXICO
        MHL
        MARSHALL ISLANDS
        MKD
        MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
        MLI
        MALI
        MLT
        MALTA
        MMR
        MYANMAR
        MNE
        MONTENEGRO
        MNG
        MONGOLIA
        MNP
        NORTHERN MARIANA ISLANDS
        MOZ
        MOZAMBIQUE
        MRT
        MAURITANIA
        MSR
        MONTSERRAT
        MTQ
        MARTINIQUE
        MUS
        MAURITIUS
        MWI
        MALAWI
        MYS
        MALAYSIA
        MYT
        MAYOTTE
        NAM
        NAMIBIA
        NCL
        NEW CALEDONIA
        NER
        NIGER
        NFK
        NORFOLK ISLAND
        NGA
        NIGERIA
        NIC
        NICARAGUA
        NIU
        NIUE
        NLD
        NETHERLANDS
        NOR
        NORWAY
        NPL
        NEPAL
        NRU
        NAURU
        NZL
        NEW ZEALAND
        OMN
        OMAN
        PAK
        PAKISTAN
        PAN
        PANAMA
        PCN
        PITCAIRN
        PER
        PERU
        PHL
        PHILIPPINES
        PLW
        PALAU
        PNG
        PAPUA NEW GUINEA
        POL
        POLAND
        PRI
        PUERTO RICO
        PRK
        KOREA, DEMOCRATIC PEOPLE’S REPUBLIC OF
        PRT
        PORTUGAL
        PRY
        PARAGUAY
        PSE
        PALESTINIAN TERRITORY, OCCUPIED
        PYF
        FRENCH POLYNESIA
        QAT
        QATAR
        REU
        RÉUNION
        ROU
        ROMANIA
        RUS
        RUSSIAN FEDERATION
        RWA
        RWANDA
        SAU
        SAUDI ARABIA
        SDN
        SUDAN
        SEN
        SENEGAL
        SGP
        SINGAPORE
        SGS
        SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
        SHN
        SAN MARINO
        SJM
        SVALBARD AND JAN MAYEN
        SLB
        SOLOMON ISLANDS
        SLE
        SIERRA LEONE
        SLV
        EL SALVADOR
        SMR
        SINT MAARTEN (DUTCH PART)
        SOM
        SOMALIA
        SPM
        HOLY SEE (VATICAN CITY STATE)
        SRB
        SERBIA
        SSD
        SOUTH SUDAN
        STP
        SAO TOME AND PRINCIPE
        SUR
        SURINAME
        SVK
        SLOVAKIA
        SVN
        SLOVENIA
        SWE
        SWEDEN
        SWZ
        SWAZILAND
        SXM
        SAINT PIERRE AND MIQUELON
        SYC
        SEYCHELLES
        SYR
        SYRIAN ARAB REPUBLIC
        TCA
        TURKS AND CAICOS ISLANDS
        TCD
        CHAD
        TGO
        TOGO
        THA
        THAILAND
        TJK
        TAJIKISTAN
        TKL
        TOKELAU
        TKM
        TURKMENISTAN
        TLS
        TIMOR-LESTE
        TON
        TONGA
        TTO
        TRINIDAD AND TOBAGO
        TUN
        TUNISIA
        TUR
        TURKEY
        TUV
        TUVALU
        TWN
        TAIWAN, PROVINCE OF CHINA
        TZA
        TANZANIA, UNITED REPUBLIC OF
        UGA
        UGANDA
        UKR
        UKRAINE
        UMI
        UNITED STATES MINOR OUTLYING ISLANDS
        URY
        URUGUAY
        USA
        UNITED STATES
        UZB
        UZBEKISTAN
        VAT
        SAINT VINCENT AND THE GRENADINES
        VCT
        SAINT LUCIA
        VEN
        VENEZUELA, BOLIVARIAN REPUBLIC OF
        VGB
        VIRGIN ISLANDS, BRITISH
        VIR
        VIRGIN ISLANDS, U.S.
        VNM
        VIET NAM
        VUT
        VANUATU
        WLF
        WALLIS AND FUTUNA
        WSM
        SAMOA
        YEM
        YEMEN
        ZAF
        SOUTH AFRICA
        ZMB
        ZAMBIA
        ZWE
        ZIMBABWE
      • issuerName
        presence
        Optional
        Interface version
        2.5

        Issuer name of the card. This data is called cardIssuerName in the reports.

      • issuerRegionCode
        presence
        Optional
        Interface version
        2.5

        region code of the card issuer

        List of values
        1
        USA: California, Hawaii, Nevada
        2
        USA: West except California, Hawaii, Nevada
        3
        USA: Central North
        4
        USA: Central South
        5
        USA: Great Lakes states
        6
        USA: South East
        7
        USA: Extreme North East
        8
        USA: North East
        9
        USA: Florida and Georgia
        A
        Canada
        B
        South America
        C
        Oceania Asia
        D
        Europe
        E
        Africa and middle east
        Empty
        Unknown
      • issuingCountryCode
        presence
        Optional
        Interface version
        2.44

        Country code in which the card has been issued. This data is called cardIssuingCountryCode in the reports.

        List of values
        ABW
        ARUBA
        AFG
        AFGHANISTAN
        AGO
        ANGOLA
        AIA
        ANGUILLA
        ALA
        ÅLAND ISLANDS
        ALB
        ALBANIA
        AND
        ANDORRA
        ARE
        UNITED ARAB EMIRATES
        ARG
        ARGENTINA
        ARM
        ARMENIA
        ASM
        AMERICAN SAMOA
        ATA
        ANTARCTICA
        ATF
        FRENCH SOUTHERN TERRITORIES
        ATG
        ANTIGUA AND BARBUDA
        AUS
        AUSTRALIA
        AUT
        AUSTRIA
        AZE
        AZERBAIJAN
        BDI
        BURUNDI
        BEL
        BELGIUM
        BEN
        BENIN
        BES
        BONAIRE, SINT EUSTATIUS AND SABA
        BFA
        BURKINA FASO
        BGD
        BANGLADESH
        BGR
        BULGARIA
        BHR
        BAHRAIN
        BHS
        BAHAMAS
        BIH
        BOSNIA AND HERZEGOVINA
        BLM
        SAINT KITTS AND NEVIS
        BLR
        BELARUS
        BLZ
        BELIZE
        BMU
        BERMUDA
        BOL
        BOLIVIA, PLURINATIONAL STATE OF
        BRA
        BRAZIL
        BRB
        BARBADOS
        BRN
        BRUNEI DARUSSALAM
        BTN
        BHUTAN
        BVT
        BOUVET ISLAND
        BWA
        BOTSWANA
        CAF
        CENTRAL AFRICAN REPUBLIC
        CAN
        CANADA
        CCK
        COCOS (KEELING) ISLANDS
        CHE
        SWITZERLAND
        CHL
        CHILE
        CHN
        CHINA
        CIV
        CÔTE D’IVOIRE
        CMR
        CAMEROON
        COD
        CONGO, THE DEMOCRATIC REPUBLIC OF THE
        COG
        CONGO
        COK
        COOK ISLANDS
        COL
        COLOMBIA
        COM
        COMOROS
        CPV
        CAPE VERDE
        CRI
        COSTA RICA
        CUB
        CUBA
        CUW
        CURAÇAO
        CXR
        CHRISTMAS ISLAND
        CYM
        CAYMAN ISLANDS
        CYP
        CYPRUS
        CZE
        CZECH REPUBLIC
        DEU
        GERMANY
        DJI
        DJIBOUTI
        DMA
        DOMINICA
        DNK
        DENMARK
        DOM
        DOMINICAN REPUBLIC
        DZA
        ALGERIA
        ECU
        ECUADOR
        EGY
        EGYPT
        ERI
        ERITREA
        ESH
        WESTERN SAHARA
        ESP
        SPAIN
        EST
        ESTONIA
        ETH
        ETHIOPIA
        FIN
        FINLAND
        FJI
        FIJI
        FLK
        FALKLAND ISLANDS (MALVINAS)
        FRA
        FRANCE
        FRO
        FAROE ISLANDS
        FSM
        MICRONESIA, FEDERATED STATES OF
        GAB
        GABON
        GBR
        UNITED KINGDOM
        GEO
        GEORGIA
        GGY
        GUERNSEY
        GHA
        GHANA
        GIB
        GIBRALTAR
        GIN
        GUINEA
        GLP
        GUADELOUPE
        GMB
        GAMBIA
        GNB
        GUINEA-BISSAU
        GNQ
        EQUATORIAL GUINEA
        GRC
        GREECE
        GRD
        GRENADA
        GRL
        GREENLAND
        GTM
        GUATEMALA
        GUF
        FRENCH GUIANA
        GUM
        GUAM
        GUY
        GUYANA
        HKG
        HONG KONG
        HMD
        HEARD ISLAND AND MCDONALD ISLANDS
        HND
        HONDURAS
        HRV
        CROATIA
        HTI
        HAITI
        HUN
        HUNGARY
        IDN
        INDONESIA
        IMN
        ISLE OF MAN
        IND
        INDIA
        IOT
        BRITISH INDIAN OCEAN TERRITORY
        IRL
        IRELAND
        IRN
        IRAN, ISLAMIC REPUBLIC OF
        IRQ
        IRAQ
        ISL
        ICELAND
        ISR
        ISRAEL
        ITA
        ITALY
        JAM
        JAMAICA
        JEY
        JERSEY
        JOR
        JORDAN
        JPN
        JAPAN
        KAZ
        KAZAKHSTAN
        KEN
        KENYA
        KGZ
        KYRGYZSTAN
        KHM
        CAMBODIA
        KIR
        KIRIBATI
        KNA
        SAINT BARTHÉLEMY
        KOR
        KOREA, REPUBLIC OF
        KWT
        KUWAIT
        LAO
        LAO PEOPLE’S DEMOCRATIC REPUBLIC
        LBN
        LEBANON
        LBR
        LIBERIA
        LBY
        LIBYA
        LCA
        SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
        LIE
        LIECHTENSTEIN
        LKA
        SRI LANKA
        LSO
        LESOTHO
        LTU
        LITHUANIA
        LUX
        LUXEMBOURG
        LVA
        LATVIA
        MAC
        MACAO
        MAF
        SAINT MARTIN (FRENCH PART)
        MAR
        MOROCCO
        MCO
        MONACO
        MDA
        MOLDOVA, REPUBLIC OF
        MDG
        MADAGASCAR
        MDV
        MALDIVES
        MEX
        MEXICO
        MHL
        MARSHALL ISLANDS
        MKD
        MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
        MLI
        MALI
        MLT
        MALTA
        MMR
        MYANMAR
        MNE
        MONTENEGRO
        MNG
        MONGOLIA
        MNP
        NORTHERN MARIANA ISLANDS
        MOZ
        MOZAMBIQUE
        MRT
        MAURITANIA
        MSR
        MONTSERRAT
        MTQ
        MARTINIQUE
        MUS
        MAURITIUS
        MWI
        MALAWI
        MYS
        MALAYSIA
        MYT
        MAYOTTE
        NAM
        NAMIBIA
        NCL
        NEW CALEDONIA
        NER
        NIGER
        NFK
        NORFOLK ISLAND
        NGA
        NIGERIA
        NIC
        NICARAGUA
        NIU
        NIUE
        NLD
        NETHERLANDS
        NOR
        NORWAY
        NPL
        NEPAL
        NRU
        NAURU
        NZL
        NEW ZEALAND
        OMN
        OMAN
        PAK
        PAKISTAN
        PAN
        PANAMA
        PCN
        PITCAIRN
        PER
        PERU
        PHL
        PHILIPPINES
        PLW
        PALAU
        PNG
        PAPUA NEW GUINEA
        POL
        POLAND
        PRI
        PUERTO RICO
        PRK
        KOREA, DEMOCRATIC PEOPLE’S REPUBLIC OF
        PRT
        PORTUGAL
        PRY
        PARAGUAY
        PSE
        PALESTINIAN TERRITORY, OCCUPIED
        PYF
        FRENCH POLYNESIA
        QAT
        QATAR
        REU
        RÉUNION
        ROU
        ROMANIA
        RUS
        RUSSIAN FEDERATION
        RWA
        RWANDA
        SAU
        SAUDI ARABIA
        SDN
        SUDAN
        SEN
        SENEGAL
        SGP
        SINGAPORE
        SGS
        SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
        SHN
        SAN MARINO
        SJM
        SVALBARD AND JAN MAYEN
        SLB
        SOLOMON ISLANDS
        SLE
        SIERRA LEONE
        SLV
        EL SALVADOR
        SMR
        SINT MAARTEN (DUTCH PART)
        SOM
        SOMALIA
        SPM
        HOLY SEE (VATICAN CITY STATE)
        SRB
        SERBIA
        SSD
        SOUTH SUDAN
        STP
        SAO TOME AND PRINCIPE
        SUR
        SURINAME
        SVK
        SLOVAKIA
        SVN
        SLOVENIA
        SWE
        SWEDEN
        SWZ
        SWAZILAND
        SXM
        SAINT PIERRE AND MIQUELON
        SYC
        SEYCHELLES
        SYR
        SYRIAN ARAB REPUBLIC
        TCA
        TURKS AND CAICOS ISLANDS
        TCD
        CHAD
        TGO
        TOGO
        THA
        THAILAND
        TJK
        TAJIKISTAN
        TKL
        TOKELAU
        TKM
        TURKMENISTAN
        TLS
        TIMOR-LESTE
        TON
        TONGA
        TTO
        TRINIDAD AND TOBAGO
        TUN
        TUNISIA
        TUR
        TURKEY
        TUV
        TUVALU
        TWN
        TAIWAN, PROVINCE OF CHINA
        TZA
        TANZANIA, UNITED REPUBLIC OF
        UGA
        UGANDA
        UKR
        UKRAINE
        UMI
        UNITED STATES MINOR OUTLYING ISLANDS
        URY
        URUGUAY
        USA
        UNITED STATES
        UZB
        UZBEKISTAN
        VAT
        SAINT VINCENT AND THE GRENADINES
        VCT
        SAINT LUCIA
        VEN
        VENEZUELA, BOLIVARIAN REPUBLIC OF
        VGB
        VIRGIN ISLANDS, BRITISH
        VIR
        VIRGIN ISLANDS, U.S.
        VNM
        VIET NAM
        VUT
        VANUATU
        WLF
        WALLIS AND FUTUNA
        WSM
        SAMOA
        YEM
        YEMEN
        ZAF
        SOUTH AFRICA
        ZMB
        ZAMBIA
        ZWE
        ZIMBABWE
      • panCheckAlgorithm
        presence
        Optional
        Interface version
        2.5

        Control algorithm applied on the PAN (L/V/N/Empty)

        List of values
        Empty
        Unknown PAN control algorithm
        L
        PAN control with Lühn Key algorithm
        N
        No PAN control algorithm
        V
        PAN control with Visa Modulus 10 algorithm
      • panLengthMax
        presence
        Optional
        Interface version
        2.5

        Maximum length of the PAN

      • panLengthMin
        presence
        Optional
        Interface version
        2.5

        Minimal length of the PAN

      • virtualCardIndicator
        presence
        Optional
        Interface version
        2.35

        Indicates whether the card is a virtual card

        List of values
        Empty
        Unknown
        N
        The card is not a virtual card
        Y
        The card is a virtual card
  • errorFieldName
    presence
    Optional
    Interface version
    2.5

    Error field name of the incoming request. Present when responseCode = 12 or 30.

  • paymentMeanInfoResponseCode
    presence
    Optional
    Interface version
    2.5

    Response code of a payment mean information request

    List of values
    00
    Payment mean information successfully found
    12
    Invalid request check the request parameters
    14
    No information found
    30
    Format error
    40
    Function not supported: the operation that you wish to perform is not part of the operation type for which you are authorised
    63
    Security rules not observed, request stopped
    90
    Service temporarily not available
    99
    Temporary problem at the Sogenactif server level

Response sample

            {
  "paymentMeanInfoResponseCode": "00",
  "cardDataList": [
    {
      "cardScheme": "CB",
      "cardBrand": "CB",
      "cardProductCode": "2",
      "cardProductName": "CARTE NATIONALE DE RETRAIT ET DE PAIEMENT",
      "issuerCode": "10107",
      "issuerCountryCode": "FRA",
      "panLengthMin": 16,
      "panLengthMax": 16,
      "panCheckAlgorithm": "L",
      "cardProductProfile": "D"
    },
    {
      "cardScheme": "VISA",
      "cardBrand": "VISA",
      "cardProductCode": "F",
      "cardProductName": "VISA CLASSIC",
      "cardCorporateIndicator": "N",
      "issuerCode": "10107",
      "issuerCountryCode": "FRA",
      "issuerRegionCode": "D",
      "panLengthMin": 16,
      "panLengthMax": 16,
      "panCheckAlgorithm": "L"
    }
  ],
  "seal": "c10bc66f574d22c4eb68250fe80c7d764a420a4fa22fde23f69e3a67bf60d131"
}

        
            <getCardDataResponse xmlns="urn:sips:cn:contract:office:paymentmeaninfo:v2">
   <output>
      <paymentMeanInfoResponseCode>00</paymentMeanInfoResponseCode>
      <cardDataList>
         <cardData>
            <cardScheme>CB</cardScheme>
            <cardBrand>CB</cardBrand>
            <cardProductCode>2</cardProductCode>
            <cardProductName>CARTE NATIONALE DE RETRAIT ET DE PAIEMENT</cardProductName>
            <cardCorporateIndicator/>
            <cardEffectiveDateIndicator/>
            <cardSeqNumberIndicator/>
            <issuerCode>10107</issuerCode>
            <issuerName/>
            <issuerCountryCode>FRA</issuerCountryCode>
            <issuerRegionCode>D</issuerRegionCode>
            <panLengthMin>16</panLengthMin>
            <panLengthMax>16</panLengthMax>
            <panCheckAlgorithm>L</panCheckAlgorithm>
            <cardProductProfile>D</cardProductProfile>
         </cardData>
         <cardData>
            <cardScheme>VISA</cardScheme>
            <cardBrand>VISA</cardBrand>
            <cardProductCode>F</cardProductCode>
            <cardProductName>VISA CLASSIC</cardProductName>
            <cardCorporateIndicator>N</cardCorporateIndicator>
            <cardEffectiveDateIndicator/>
            <cardSeqNumberIndicator/>
            <issuerCode>10107</issuerCode>
            <issuerName/>
            <issuerCountryCode>FRA</issuerCountryCode>
            <issuerRegionCode>D</issuerRegionCode>
            <panLengthMin>16</panLengthMin>
            <panLengthMax>16</panLengthMax>
            <panCheckAlgorithm>L</panCheckAlgorithm>
            <cardProductProfile/>
         </cardData>
      </cardDataList>
   </output>
</getCardDataResponse>

        

Changelog


Interface version Data Attendance Container
2.5 cardIIN Request
2.5 cardNumber Request
2.12 intermediateServiceProviderId Request
2.12 sealAlgorithm Request
2.5 interfaceVersion Request
2.5 keyVersion Request
2.5 merchantId Request
2.5 seal Request/Response
2.5 cardDataList Response
2.5 cardData Container
  • cardDataList
  • 2.5 cardBrand Container
  • cardData
  • 2.5 cardCorporateIndicator Container
  • cardData
  • 2.5 cardEffectiveDateIndicator Container
  • cardData
  • 2.5 cardProductCode Container
  • cardData
  • 2.5 cardProductName Container
  • cardData
  • 2.5 cardProductProfile Container
  • cardData
  • 2.45 cardProductUsageLabel Container
  • cardData
  • 2.5 cardScheme Container
  • cardData
  • 2.5 cardSeqNumberIndicator Container
  • cardData
  • 2.5 issuerCode Container
  • cardData
  • 2.5 issuerCountryCode Container
  • cardData
  • 2.5 issuerName Container
  • cardData
  • 2.5 issuerRegionCode Container
  • cardData
  • 2.44 issuingCountryCode Container
  • cardData
  • 2.5 panCheckAlgorithm Container
  • cardData
  • 2.5 panLengthMax Container
  • cardData
  • 2.5 panLengthMin Container
  • cardData
  • 2.35 virtualCardIndicator Container
  • cardData
  • 2.5 errorFieldName Response
    2.5 paymentMeanInfoResponseCode Response

    This site uses trackers to improve your experience, perform analysis and researches on your use of Sogenactif documentation website.
    You have several options:
    Closing this banner you refuse the use of trackers on your device.

    Configuration