Lotto Service Interface (2.0.0)

The Electrum Lotto Service Interface describes an interface for creating, confirming and reversing Lotto wagers.

Download OpenAPI description
Languages
Servers

https://[placeholder].dev/lotto/v2/

Lotto Game Rules Service Interface

The Lotto Game Rules Service Interface API.

Operations

Lotto Games Service Interface

The Lotto Games Service Interface API.

Operations

Lotto Wager Service Interface

The Lotto Wager Service Interface API.

Operations

Schema

ThreeDSecureDataV1

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" }

ThreeDSecureDataV2

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" }

TransactionLabel

A label assigned to a transaction by the entity processing the transaction. Labels are used for grouping or discovering transactions after transaction processing. Note that no transaction processing decision is made based on transaction labels.

namestring^[a-zA-Z0-9_]{1,100}$required

Label name that indicates the type and intended use of the transaction label. The meaning of label names must be agreed upon by the parties involved in transaction processing.

valuestring^[a-zA-Z.-9 _-]{1,100}$required

The value assigned to the transaction label.

{ "name": "string", "value": "string" }