Skip to main content
POST
/
cards
/
{cardId}
/
apple-wallet
Create an Apple digital wallet token
curl --request POST \
  --url https://api.equalsmoney.com/v2/cards/{cardId}/apple-wallet \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "deviceType": "WATCH",
  "provisioningAppVersion": "2.11.1",
  "certificates": "['MIIEPDCCA+KgAwIBAgICEAAwCQYHKoZIzj', 'MIIDZjCCAw2gAwIBAgIJAJx22AGaEPSgMA']",
  "nonce": "vXWJaBidcTLaJJCF",
  "nonceSignature": "jD4Aphu+93N2wbBn"
}
EOF
{
  "deviceType": "WATCH",
  "provisioningAppVersion": "2.11.1",
  "certificates": "['MIIEPDCCA+KgAwIBAgICEAAwCQYHKoZIzj', 'MIIDZjCCAw2gAwIBAgIJAJx22AGaEPSgMA']",
  "nonce": "vXWJaBidcTLaJJCF",
  "nonceSignature": "jD4Aphu+93N2wbBn",
  "encryptedPassData": "w9NGKYa3OkPGeQ+FmAKGga",
  "activationData": "TUJQQUMtMS1GSy03NDgwNTIuMS0tVERF",
  "ephemeralPublicKey": "BMop3NufgKwy/r0GX1muvomvw"
}

Authorizations

​
Authorization
string
header
required

Path Parameters

​
cardId
string<uuid>
required

The ID of the card to work with.

Maximum string length: 36
Example:

"e9293471-5eb3-4dbc-916c-dbaf9e2deefd"

Query Parameters

​
accountId
string
required

The ID of the account to work with.

Example:

"F50091"

​
personId
string<uuid>

The ID of the person to work with.

Maximum string length: 36
Example:

"775596ae-2624-40af-a9dc-9756110a4a04"

Body

application/json

Body

​
deviceType
enum<string>
required

The type of device into which the digital wallet token is provisioned.

Available options:
MOBILE_PHONE,
TABLET,
WATCH
Example:

"WATCH"

​
provisioningAppVersion
string
required

The version of the application making the provisioning request. This is used for debugging and fraud prevention.

Maximum string length: 50
Example:

"2.11.1"

​
certificates
string[]
required

The Base64-encoded leaf and sub-CA certificates provided by Apple. The first element of the array should be the leaf certificate, followed by the sub-CA.

Example:

"['MIIEPDCCA+KgAwIBAgICEAAwCQYHKoZIzj', 'MIIDZjCCAw2gAwIBAgIJAJx22AGaEPSgMA']"

​
nonce
string
required

The single-use nonce provided by Apple for security purposes.

Example:

"vXWJaBidcTLaJJCF"

​
nonceSignature
string
required

The signature to the nonce provided by Apple.

Example:

"jD4Aphu+93N2wbBn"

Response

201 - application/json

Created

​
deviceType
enum<string>

The type of device into which the digital wallet token is provisioned.

Available options:
MOBILE_PHONE,
TABLET,
WATCH
Example:

"WATCH"

​
provisioningAppVersion
string

The version of the application making the provisioning request. This is used for debugging and fraud prevention.

Maximum string length: 50
Example:

"2.11.1"

​
certificates
string[]

The Base64-encoded leaf and sub-CA certificates provided by Apple. The first element of the array should be the leaf certificate, followed by the sub-CA.

Example:

"['MIIEPDCCA+KgAwIBAgICEAAwCQYHKoZIzj', 'MIIDZjCCAw2gAwIBAgIJAJx22AGaEPSgMA']"

​
nonce
string

The single-use nonce provided by Apple for security purposes.

Example:

"vXWJaBidcTLaJJCF"

​
nonceSignature
string

The signature to the nonce provided by Apple.

Example:

"jD4Aphu+93N2wbBn"

​
encryptedPassData
string

A payload encrypted with a shared key derived from the Apple Public Certificates and the generated ephemeral private key.

Example:

"w9NGKYa3OkPGeQ+FmAKGga"

​
activationData
string

A cryptographic one-time passcode conforming to the specifications of the payment network operator or service provider.

Example:

"TUJQQUMtMS1GSy03NDgwNTIuMS0tVERF"

​
ephemeralPublicKey
string

The ephemeral public key used for the provisioning attempt.

Example:

"BMop3NufgKwy/r0GX1muvomvw"