Download OpenAPI specification:Download
Activates a new XPay token.
ActivateTokenReq
OK
Bad Request
Internal Server Error
{- "CardID": 16263,
- "TokenID": 182,
- "Reason": "",
- "ClientRequestReference": "[ReferenceExample]",
- "CultureID": 1
}
{- "Description": "Success",
- "ResponseCode": "000",
- "ResponseDateTime": "2021-12-21T13:58:02.899",
- "ClientRequestReference": "reference",
- "RequestID": 27194
}
Permanently removes the XPay token.
DeleteTokenReq
OK
Bad Request
Internal Server Error
{- "CardID": 16263,
- "TokenID": 182,
- "Reason": "",
- "ClientRequestReference": "[ReferenceExample]",
- "CultureID": 1
}
{- "Description": "Success",
- "ResponseCode": "000",
- "ResponseDateTime": "2021-12-21T13:58:02.899",
- "ClientRequestReference": "reference",
- "RequestID": 27194
}
This API is used to retrieve information about Token Requestors that have been enabled for one or more of the Issuers account ranges.
GetEligibleTokenRequestorsReq
OK
Bad Request
Internal Server Error
{- "requestId": "123456",
- "accountRanges": 182,
- "supportsTokenConnect": true,
- "ClientRequestReference": "[ReferenceExample]",
- "CultureID": 1
}
{- "responseId": "123456",
- "tokenRequestors": [
- {
- "tokenRequestorId": "50123456789",
- "name": "Sunrise Ave. Ltd",
- "consumerFacingEntityName": "Happy Sunrise Online",
- "imageAssetId": "dbc55444-496a-4896-b41c-5d5e2dd431e2",
- "tokenRequestorType": "MERCHANT",
- "walletId": "123",
- "enabledAccountRanges": [
- 0
], - "supportedPushMethods": [
- "string"
], - "supportsMultiplePushedCards": true,
- "supportedAccountHolderData": [
- "string"
], - "supportsCardHolderAuthentication": true,
- "supportsTokenConnect": true,
- "supportIssuerInitiatedDigitizationData": true
}
], - "errors": [
- {
- "source": "INPUT",
- "reasonCode": "INVALID_FIELD_LENGTH",
- "description": "Invalid Field Length - {field name}",
- "errorCode": "1234",
- "recoverable": true
}
], - "Description": "Success",
- "ResponseCode": "000",
- "ResponseDateTime": "2021-12-21T13:58:02.899",
- "ClientRequestReference": "reference",
- "RequestID": 27194
}
This API is used to retrieve static Assets from MDES repository, such as the Token Requestor logo. Every Asset in the repository is referenced using an Asset ID.
OK
Bad Request
Internal Server Error
{- "mediaContents": [
- {
- "type": "image/png",
- "data": "iVBORw0KGgoAAAANSUhEUgAAAXcAAAF3CAIAAADRopypAAAABGdBTUEAANbY1E9YMgAAAAlwSFlzAAAASAAAAEgARslrPgAAGtNJREFUeNrt3W9oW",
- "height": 192,
- "width": 192
}
], - "Description": "Success",
- "ResponseCode": "000",
- "ResponseDateTime": "2021-12-21T13:58:02.899",
- "ClientRequestReference": "reference",
- "RequestID": 27194
}
GetXPayInAppActivationPayLoad method is used to generate In App activation payload.
ProvisioningPayLoadReq
OK
Bad Request
Internal Server Error
{- "CardID": 14023,
- "TokenRequestorCode": "APLPAY",
- "ClientRequestReference": "[ReferenceExample]",
- "CultureID": 1
}
{- "ActivationData": "bmV0d29yayBzcGVjaWZpYw==",
- "Description": "Success",
- "ResponseCode": "000",
- "ResponseDateTime": "2021-12-21T13:58:02.899",
- "ClientRequestReference": "reference",
- "RequestID": 27194
}
GetXPayInAppProvisioningPayLoad method is used to generate In App provisioning payload.
ProvisioningPayLoadReq
OK
Bad Request
Internal Server Error
{- "CertificateLeaf": "MIID/TCCA6OgAwIBAgIIGM2CpiS9WyYwCgYIKoZIzj0EAwIwgYAxNDAyBgNVBAMMK0FwcGxlIFdvcmxkd2lkZSBEZXZlbG9wZXIgUmVsYXRpb25zIENBIC0gRzIxJjAkBgNVBAsMHUFwcGxlIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRMwEQYDVQQKDApBcHBsZSBJbmMuMQswCQYDVQQGEwJVUzAeFw0xODA2MDEyMjE0MTVaFw0yMDA2MzAyMjE0MTVaMGwxMjAwBgNVBAMMKWVjYy1jcnlwdG8tc2VydmljZXMtZW5jaXBoZXJtZW50X1VDNi1QUk9EMRQwEgYDVQQLDAtpT1MgU3lzdGVtczETMBEGA1UECgwKQXBwbGUgSW5jLjELMAkGA1UEBhMCVVMwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAASzCVyQGX3syyW2aI6nyfNQe+vjjzjU4rLO0ZiWiVZZSmEzYfACFI8tuDFiDLv9XWrHEeX0/yNtGVjwAzpanWb/o4ICGDCCAhQwDAYDVR0TAQH/BAIwADAfBgNVHSMEGDAWgBSEtoTMOoZichZZlOgao71I3zrfCzBHBggrBgEFBQcBAQQ7MDkwNwYIKwYBBQUHMAGGK2h0dHA6Ly9vY3NwLmFwcGxlLmNvbS9vY3NwMDMtYXBwbGV3d2RyY2EyMDUwggEdBgNVHSAEggEUMIIBEDCCAQwGCSqGSIb3Y2QFATCB/jCBwwYIKwYBBQUHAgIwgbYMgbNSZWxpYW5jZSBvbiB0aGlzIGNlcnRpZmljYXRlIGJ5IGFueSBwYXJ0eSBhc3N1bWVzIGFjY2VwdGFuY2Ugb2YgdGhlIHRoZW4gYXBwbGljYWJsZSBzdGFuZGFyZCB0ZXJtcyBhbmQgY29uZGl0aW9ucyBvZiB1c2UsIGNlcnRpZmljYXRlIHBvbGljeSBhbmQgY2VydGlmaWNhdGlvbiBwcmFjdGljZSBzdGF0ZW1lbnRzLjA2BggrBgEFBQcCARYqaHR0cDovL3d3dy5hcHBsZS5jb20vY2VydGlmaWNhdGVhdXRob3JpdHkvMDYGA1UdHwQvMC0wK6ApoCeGJWh0dHA6Ly9jcmwuYXBwbGUuY29tL2FwcGxld3dkcmNhMi5jcmwwHQYDVR0OBBYEFI5aYtQKaJCRpvI1Dgh+Ra4x2iCrMA4GA1UdDwEB/wQEAwIDKDASBgkqhkiG92NkBicBAf8EAgUAMAoGCCqGSM49BAMCA0gAMEUCIAY/9gwN/KAAw3EtW3NyeX1UVM3fO+wVt0cbeHL8eM/mAiEAppLm5O/2Ox8uHkxI4U/kU5vDhJA21DRbzm2rsYN+EcQ=",
- "CertificateSubCA": "MIIC9zCCAnygAwIBAgIIb+/Y9emjp+4wCgYIKoZIzj0EAwIwZzEbMBkGA1UEAwwSQXBwbGUgUm9vdCBDQSAtIEczMSYwJAYDVQQLDB1BcHBsZSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTETMBEGA1UECgwKQXBwbGUgSW5jLjELMAkGA1UEBhMCVVMwHhcNMTQwNTA2MjM0MzI0WhcNMjkwNTA2MjM0MzI0WjCBgDE0MDIGA1UEAwwrQXBwbGUgV29ybGR3aWRlIERldmVsb3BlciBSZWxhdGlvbnMgQ0EgLSBHMjEmMCQGA1UECwwdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE3fC3BkvP3XMEE8RDiQOTgPte9nStQmFSWAImUxnIYyIHCVJhysTZV+9tJmiLdJGMxPmAaCj8CWjwENrp0C7JGqOB9zCB9DBGBggrBgEFBQcBAQQ6MDgwNgYIKwYBBQUHMAGGKmh0dHA6Ly9vY3NwLmFwcGxlLmNvbS9vY3NwMDQtYXBwbGVyb290Y2FnMzAdBgNVHQ4EFgQUhLaEzDqGYnIWWZToGqO9SN863wswDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBS7sN6hWDOImqSKmd6+veuv2sskqzA3BgNVHR8EMDAuMCygKqAohiZodHRwOi8vY3JsLmFwcGxlLmNvbS9hcHBsZXJvb3RjYWczLmNybDAOBgNVHQ8BAf8EBAMCAQYwEAYKKoZIhvdjZAYCDwQCBQAwCgYIKoZIzj0EAwIDaQAwZgIxANmxxzHGI/ZPTdDZR8V9GGkRh3En02it4Jtlmr5s3z9GppAJvm6hOyywUYlBPIfSvwIxAPxkUolLPF2/axzCiZgvcq61m6oaCyNUd1ToFUOixRLal1BzfF7QbrJcYlDXUfE6Wg==",
- "Nonce": "ea07fc0a",
- "NonceSignature": "40a37b279e5da4c0a86119b7581312a122c424ed13571a550e0e4270aeed35b2078db329b92b4997a51d90a7f8b10104e545427901d392113eb58310cde304d793d40937de3794f5ff8951b26ee0cf27c4",
- "CardID": 14023,
- "TokenRequestorCode": "APLPAY",
- "AppID": "solaris-canvas-androidapp",
- "DeviceID": "000000000000000000000000000000000000000000000000",
- "WalletAccountID": "Zmn0D_WHF6BuLGaGYceiq1Zl",
- "ClientRequestReference": "[ReferenceExample]",
- "CultureID": 1
}
{- "EncryptedData": "4+9rov+gW2mF/hKePLaEXE6h6UrpjTGlOKTiSQb7cg12TWQIlM2d587AARQ5ZlGhzK7c9IDFepWeklwESSuc + F / HEfqzy + 0Q3CupmiuwY87 /jeE =",
- "EphemeralPublicKey": "BJmm9C6D6k8VCnh4D/tWLJzbm3UHvF0oy/v4zD7wr2izbmDLENtpEngw9/iZSSAXCJ47c8g/zw698sBrYTw / iLc = ",
- "ActivationData": "bmV0d29yayBzcGVjaWZpYw==",
- "Description": "Success",
- "ResponseCode": "000",
- "ResponseDateTime": "2021-12-21T13:58:02.899",
- "ClientRequestReference": "reference",
- "RequestID": 27194
}
Returns list of XPay tokens based on the search criteria.
ListTokensReq
OK
Bad Request
Internal Server Error
{- "DeviceID": "000000000000000000000000000000000000000000000000",
- "WalletAccountID": "Zmn0D_WHF6BuLGaGYceiq1Zl",
- "TokenRequestorCode": "GGLPAY",
- "CardID": 14023,
- "ClientRequestReference": "[ReferenceExample]",
- "CultureID": 1
}
{- "XPayTokenResList": [
- {
- "TokenID": 196,
- "TokenReferenceID": "00000000000000000000000000000001",
- "TokenType": "05",
- "TokenExpiryDate": 0,
- "TokenStatus": "I",
- "DeviceType": "01",
- "DeviceID": "000000000000000000000000000000000000000000000000",
- "DeviceNumber": 0,
- "DeviceName": "Bob's Phone",
- "DeviceIMEI": "",
- "TokenPresentationTypeID": 0,
- "DeviceSerialNumber": "",
- "TokenRequestorCode": "APLPAY",
- "TokenRequestorName": "Apple Pay",
- "TokenNumber": "",
- "WalletAccountID": "Zmn0D_WHF6BuLGaGYceiq1Zl"
}
], - "Description": "Success",
- "ResponseCode": "000",
- "ResponseDateTime": "2021-12-21T13:58:02.899",
- "ClientRequestReference": "reference",
- "RequestID": 27194
}
This API is used to Push multiple Cards and/or multiple Financial Account to a given Token Requestor.
PushAccountsPayLoadReq
OK
Bad Request
Internal Server Error
{- "requestId": "123456",
- "CardID": 14023,
- "TokenRequestorCode": "APLPAY",
- "AppID": "solaris-canvas-androidapp",
- "DeviceID": "000000000000000000000000000000000000000000000000",
- "WalletAccountID": "Zmn0D_WHF6BuLGaGYceiq1Zl",
- "ClientRequestReference": "[ReferenceExample]",
- "CultureID": 1
}
{- "responseId": "123456",
- "pushAccountReceipts": [
- {
- "pushAccountId": "CA-132d72d4fcb2f4136a0532d3093ff1ab",
- "pushAccountReceipt": "MCC-C307F0AE-298E-48EB-AA43-A7C40B32DDDE",
- "issuerInitiatedDigitizationData": "eyJmdW5kaW5nQWNjb3VudEluZm8iOnsicHVzaEFjY291bnRSZWNlaXB0IjoiTUNDLVNUTC00OTZCNjNBOC02OTQzLTRFM0YtOEYzNi1DMjU0M0Q4OTg1ODQifX0=",
- "errors": [
- {
- "source": "INPUT",
- "reasonCode": "INVALID_FIELD_LENGTH",
- "description": "Invalid Field Length - {field name}",
- "errorCode": "1234",
- "recoverable": true
}
]
}
], - "tokenRequestorSignatureSupport": true,
- "signature": "ew0KImFsZyI6ICJSUzI1NiIsDQoNCiJraWQiOiAiYXNkZmctcXdlcnR5LXp4Y3ZiIg0KfQ.ew0KDQrCoCJwdXNoQWNjb3VudFJlY2VpcHQiOiAiTUNDLVNUTC0xMzQzMTNCRi01NTg1LTRFNzEtQUIyNC1FQ0RCQzI4RjIzRjEiLA0KImlzc3VlckNhbGxCYWNrIjogImh0dHBzOi8vaXNzdWVyY2FsbGJhY2sudXJsIiwNCiJjYWxsYmFja1JlcXVpcmVkIjogdHJ1ZSwNCiJjb21wbGV0ZVdlYnNpdGVBY3RpdmF0aW9uIjogdHJ1ZSwNCiJhY2NvdW50SG9sZGVyRGF0YVN1cHBsaWVkIjogdHJ1ZSwNCiJsb2NhbGUiOiAiZW5fVVMiDQoNCn0.dBjftJeZ4CVP-",
- "Errors": [
- {
- "source": "INPUT",
- "reasonCode": "INVALID_FIELD_LENGTH",
- "description": "Invalid Field Length - {field name}",
- "errorCode": "1234",
- "recoverable": true
}
], - "Description": "Success",
- "ResponseCode": "000",
- "ResponseDateTime": "2021-12-21T13:58:02.899",
- "ClientRequestReference": "reference",
- "RequestID": 27194
}
Sends a new activation code for the specified token to the account holder.
ActivateTokenReq
OK
Bad Request
Internal Server Error
{- "CardID": 16263,
- "TokenID": 182,
- "Reason": "",
- "ClientRequestReference": "[ReferenceExample]",
- "CultureID": 1
}
{- "Description": "Success",
- "ResponseCode": "000",
- "ResponseDateTime": "2021-12-21T13:58:02.899",
- "ClientRequestReference": "reference",
- "RequestID": 27194
}
Changes the status of the XPay token from inactive/suspended to active.
ResumeTokenReq
OK
Bad Request
Internal Server Error
{- "CardID": 16263,
- "TokenID": 182,
- "Reason": "",
- "ClientRequestReference": "[ReferenceExample]",
- "CultureID": 1
}
{- "Description": "Success",
- "ResponseCode": "000",
- "ResponseDateTime": "2021-12-21T13:58:02.899",
- "ClientRequestReference": "reference",
- "RequestID": 27194
}
Suspends the specified XPay token without deleting it.
SuspendTokenReq
OK
Bad Request
Internal Server Error
{- "CardID": 16263,
- "TokenID": 182,
- "Reason": "",
- "ClientRequestReference": "[ReferenceExample]",
- "CultureID": 1
}
{- "Description": "Success",
- "ResponseCode": "000",
- "ResponseDateTime": "2021-12-21T13:58:02.899",
- "ClientRequestReference": "reference",
- "RequestID": 27194
}