GetEMVReceiptData

  • Method

    Slimcd.Images.GetEMVReceiptData

    Purpose

    Get EMV Receipt Data.

    Description

    Returns all of the transactions “EMV tags” needed for a receipt. The data can be returned as plain text or as XML.

    Business Rules

    Use this to retrieve the EMV tags needed to print a receipt when generating your own receipts from a payment system.

    Argument List

    Name Required Usage
    GetEMVReceiptData Required Object containing properties for the request
    timeout Optional Integer wait time, in seconds, before timeout response is generated
    callback* Optional Function to call upon completion of asynchronous request

    *for JavaScript only

    GetEMVReceiptData Request Fields

    Field Name Type Length Required Description
    Username string 20 require Username or API Access Credential that accesses web service.
    Password string 20 require Plaintext password for the client account.
    GateID int 12 require Slim CD GateID/Ticket# for the transaction
    XML string 3 optional yes/no or 1/0 to represent XML vs plaintext format returned.

    1. Passwords are required except when the username is set to an API Access Credential, in which case it should be passed in as an empty string.

    Reply Fields

    * For XML FORMAT ONLY!

    reply outer tag for the reply data block
    response Success, FAIL, Error
    response code 0, 1, 2 (respective) matching the above
    description If successful, this will contain the single word, OK. Otherwise it will contain a description of failure or error which occurred
    reponseurl The Slimcd.com url which was called for this operation
    datablock The tags needed for the receipt.

    * For TEXT FORMAT ONLY!
    PlainText that can be placed on the receipt

    The following values are always returned: (in plaintext or in the datablock)

    EMVMode: (Chip Read/FallbackMSR/FallbackTech/OfflineChip/OfflineStandIn/OfflineStoreAndForward/Contactless)
    Source: (Card/Issuer)
    Entry: (ChipCard/ChipPIN/Tapped/Swiped/Keyed)
    ARC (8A):
    AID (4F):
    TVR (95):
    TSI (9B):
    IAD (9F10):

    If the chip declined the transaction, the following tags are returned:
    Tag50
    Tag5F2A
    Tag5F34
    Tag82
    Tag95
    Tag9A
    Tag9C
    Tag9F02
    Tag9F03
    Tag9F07
    Tag9F0D
    Tag9F0E
    Tag9F0F
    Tag9F12
    Tag9F1A
    Tag9F26
    Tag9F27
    Tag9F34
    Tag9F36
    Tag9F37
    TagDF03
    TagDF04
    TagDF05

    Reply Hierarchy

    • reply
      • response
      • responsecode
      • description
      • responseurl
      • datablock
        • Tag
        • Value

    Remarks

    • General
      1. Names in name/value pairs are NOT case-sensitive
      2. Names inside XML tags ARE case-sensitive
    • Function-Specific
      1. None
  • URL
    https://stats.slimcd.com/wswebservices/GetEMVReceiptData.asp

    Remarks

      • Sample PlainText
    EMVMode: Chip Read
    Source: Card
    Entry: ChipCard
    ARC (8A): Z1
    AID (4F): A000000025010801
    TVR (95): 0880008000
    TSI (9B): E800
    IAD (9F10): 06020103A40002
    —————————
    Tag 50: AMERICAN EXPRESS
    Tag 5F2A: 0840
    Tag 5F34: 00
    AIP(82): 3C00
    TVR(95): 0880008000
    Tag 9A: 150427
    Tag 9C: 00
    Tag 9F02: 66.00
    Tag 9F03: 0.00
    Tag 9F07:
    Tag 9F0D:
    Tag 9F0E:
    Tag 9F0F:
    Tag 9F12:
    Tag 9F1A: 0840
    Tag 9F26: 31CE46B75A68D892
    Tag 9F27: 80
    Tag 9F34: 5E0300
    Tag 9F36: 0001
    Tag 9F37: FA01357A
    TAC Default(DF03):
    TAC Denial(DF04):
    TAC Online(DF05): 5858
      • Sample XML
    <reply>
    <response>Success</response>
    <responsecode>0</responsecode>
    <description>OK</description>
    <datablock>
    <EMVMode>Chip Read</EMVMode>
    <Source>Card</Source>
    <Entry>ChipCard</Entry>
    <ARC tag=”8A” description=”Application Response Code”>Z1</ARC>
    <AID tag=”4F”   description=”Application Identifier”>A000000025010801</AID>
    <TVR tag=”95″   description=”Terminal Verification Results”>0880008000</TVR>
    <IAD tag=”9F10″ description=”Issuer Application Data”>06020103A40002</IAD>
    <TSI tag=”9B”    description=”Transaction Status Indicator”>E800</TSI>
    <Tag50 abbr=”” description=”Application Label”>AMERICAN EXPRESS</Tag50>
    <Tag5F2A abbr=”” description=”Transaction Currency Code”>0840</Tag5F2A>
    <Tag5F34 abbr=”” description=”PAN Sequence Number”>00</Tag5F34>
    <Tag82 abbr=”AIP” description=”Application Interchange Profile”>3C00</Tag82>
    <Tag95 abbr=”TVR” description=”Terminal Verification Results”>0880008000</Tag95>
    <Tag9A abbr=”” description=”Transaction Date”>150427</Tag9A>
    <Tag9C abbr=”” description=”Transaction Time”>00</Tag9C>
    <Tag9F02 abbr=”” description=”Amount Authorized”>66.00</Tag9F02>
    <Tag9F03 abbr=”” description=”Other Amount”>0.00</Tag9F03>
    <Tag9F07 abbr=”” description=”Application Usage Control”></Tag9F07>
    <Tag9F0D abbr=”” description=”Issuer Action Code – Default”></Tag9F0D>
    <Tag9F0E abbr=”” description=”Issuer Action Code – Denial”></Tag9F0E>
    <Tag9F0F abbr=”” description=”Issuer Action Code – Online”></Tag9F0F>
    <Tag9F12 abbr=”” description=”Application Preferred Name”></Tag9F12>
    <Tag9F1A abbr=”” description=”Terminal Country Code”>0840</Tag9F1A>
    <Tag9F26 abbr=”” description=”Application Cryptogram”>31CE46B75A68D892</Tag9F26>
    <Tag9F27 abbr=”” description=”Cryptogram Information Data”>80</Tag9F27>
    <Tag9F34 abbr=”” description=”CVM Results”>5E0300</Tag9F34>
    <Tag9F36 abbr=”” description=”Application Transaction Data”>0001</Tag9F36>
    <Tag9F37 abbr=”” description=”Unpredictable Number”>FA01357A</Tag9F37>
    <TagDF03 abbr=”TAC Default” description=”Terminal Action Code Default”></TagDF03>
    <TagDF04 abbr=”TAC Denial” description=”Terminal Action Code Denial”></TagDF04>
    <TagDF05 abbr=”TAC Online” description=”Terminal Action Code Online”>5858</TagDF05>
    </datablock>
    </reply>