SlipLine

URL

https://electrum.co.za/contact

Electrum Support

support@electrum.co.za

License

Apache 2.0

SlipData

Data that may be printed on the customer slip for information purposes

messageLinesArray of objects(SlipLine)

An array of text lines and optional formatting to be printed on the customer slip.

slipWidthinteger(int32)

The width of the slip in normal (unformatted) characters.

issuerReferencestring[A-Z0-9]{1,40}

An identifier that is printed on the customer slip and uniquely identifies the payment on the service provider's system. This value is used by the customer to request a refund when the service supports this function, and it is thus important that this number is unique.

{
  "messageLines": [
    { … }
  ],
  "slipWidth": 0,
  "issuerReference": "string"
}

SlipLine

A line of text to be printed on the till slip

barcodeobject(Barcode)

Used to indicate barcode information for a slip line.

textstringrequired

Text contained on the line

fontWidthScaleFactornumber(double)

Scale factor for font width. Assume 1.0 (i.e. normal size) if not present.

fontHeightScaleFactornumber(double)

Scale factor for font height. Assume 1.0 (i.e. normal size) if not present.

lineboolean

Denotes a solid line on the slip. Assume false if not present.
Default: false

cutboolean

Indicates the slip should be cut at this line. Assume false if not present.
Default: false

{
  "barcode": {
    "data": "string",
    "encoding": "string"
  },
  "text": "string",
  "fontWidthScaleFactor": 0.1,
  "fontHeightScaleFactor": 0.1,
  "line": true,
  "cut": true
}

ThreeDSecureData

Data used to facilitate and communicate the result of 3-D Secure cardholder authentication.

authenticationValuestring

A 20-byte value that has been Base64 encoded. This value is provided by the Access Control Server as a proof of authentication.

cardHolderAuthVerificationResultstring

Authentication outcome set by the Access Control Server or Issuer.

Enum"CAVV_VALIDATION_PASSED""CAVV_VALIDATION_FAILED_ISSUER_SYSTEM_ERROR""CAVV_VALIDATION_FAILED_ISSUER_ATTEMPT_INCOMPLETE""CAVV_NOT_VALIDATED""CAVV_NOT_VALIDATED_INVALID_DATA""CAVV_VALIDATION_FAILED"

versionstringrequired

The version of the 3-D Secure protocol that was used for cardholder authentication. Note that the version determines the format of the transaction identifier

Enum"V1""V2"

Discriminator

ecistring

Electronic Commerce Indicator. This is Payment System-specific value provided by the Access Control Server to indicate the results of the attempt to authenticate the Cardholder.

Enum"AUTHENTICATION_NOT_ATTEMPTED_OR_UNSUCCESSFUL_00""AUTHENTICATION_NOT_ENABLED_01""AUTHENTICATION_SUCCESSFUL_02""AUTHENTICATION_SUCCESSFUL_05""AUTHENTICATION_NOT_ENABLED_06""AUTHENTICATION_NOT_ATTEMPTED_OR_UNSUCCESSFUL_07"

transactionStatusstring

Indicates whether a transaction qualifies as an authenticated transaction or account verification. The values and their meanings are as follows: Y = Authentication Verification Successful. N = Not Authenticated /Account Not Verified; Transaction denied. U = Authentication/ Account Verification Could Not Be Performed; Technical or other problem. A = Attempts Processing Performed; Not Authenticated/ Verified, but a proof of attempted authentication/verification is provided. C = Challenge Required; Additional authentication is required using the CReq/CRes D = Challenge Required; Decoupled Authentication confirmed. R = Authentication/ Account Verification Rejected; Issuer is rejecting authentication/verification and request that authorisation not be attempted. I = Informational Only; 3DS Requestor challenge preference acknowledged. S = Challenge using SPC

Enum"Y""N""U""A""C""D""R""I""S"

transactionIdstring

A 20-byte base 64 encoded string assigned by the 3DS Server to identify a single transaction. This ID can be used to prevent transaction replay.

{
  "authenticationValue": "string",
  "cardHolderAuthVerificationResult": "CAVV_VALIDATION_PASSED",
  "version": "ThreeDSecureDataV1",
  "eci": "AUTHENTICATION_NOT_ATTEMPTED_OR_UNSUCCESSFUL_00",
  "transactionStatus": "Y",
  "transactionId": "string"
}

Lotto Service Interface (2.0.0)

Lotto Game Rules Service Interface

Lotto Games Service Interface

Lotto Wager Service Interface

Schema

SlipData

SlipLine

ThreeDSecureData