Token provisioning response received

All network calls to Pismo for tokenization (usually originating from a payment app such as Apple Pay), generate an event, allowing you to track token provisioning through creation to deletion. See the Cards tokenization flow and events guide for more information.

Type: object
Domain: cards-tokenization
Event: notification
Version: 1

|
account_id required

Title: Accound ID
Description: Pismo account ID.
Type: integer or null
Example:
24146066

card_id required

Title: Card ID
Description: Pismo card ID
Type: integer
Example:
42488842

network_call_method required

Title: Network call method
Description: Network outbound method identifier, serves to parse raw message from network_data
Type: string
Must be one of the following:
VTS_STATUS_UPDATED_TOKEN_DEACTIVATED
VTS_STATUS_UPDATED_TOKEN_SUSPEND
VTS_STATUS_UPDATED_TOKEN_RESUME
VTS_STATUS_UPDATED_OTP_VERIFICATION_RESULT
VTS_STATUS_UPDATED_TOKEN_DEVICE_BINDING_REMOVED
VTS_STATUS_UPDATED_CALL_CENTER_ACTIVATION
VTS_STATUS_UPDATED_CARDHOLDER_STEPUP_RESULT
VTS_STATUS_UPDATED_LUK_REPLENISHMENT
VTS_STATUS_UPDATED_DEVICE_PROVISIONING_RESULT
VTS_TOKEN_ACTIVATION_STIP
VTS_TOKEN_CREATED
VTS_APPROVE_PROVISIONING
VTS_APPROVE_PROVISIONING_ISO
VTS_GET_CVM
VTS_DEVICE_BINDING
VTS_PASSCODE
TE
TA
AC
TC
TV

network_data required

Title: Network data
Description: Raw data from network. Varies according to flow and network brand
Type: object

token_id

Title: Token ID
Description: Pismo-created token ID.
Type: integer
Example:
42488842
93827266

send_challenge

Title: Send Challenge
Description: The object should be present when issuer it is responsible for sending OTP challenge to issuer.
Type: object or null

otp_value

Title: The OTP value
Description: issuer must send this value to cardholder using the chosen otp_method
Type: string
Example:
123456

otp_method

Title: One time passcode method
Description: OTP (one-time passcode) challenge customer selected for token provisioning.
Type: string
Example:
OTPSMS
OTPEMAIL

pismo_response

Title: Pismo response
Description: Pismo response to payment network. Response depends on network payment and network_call_method. Logs the final response from Pismo to the network payment. Should be null in async network calls that expect null values.
Type: object or null
Additional properties: true
Example:

{
    "actionCode": "85",
    "cvv2ResultsCode": "M"
}
{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "title": "Token provisioning response received",
    "description": "All network calls to Pismo for tokenization (usually originating from a payment app such as Apple Pay), generate an event, allowing you to track token provisioning through creation to deletion. See the <a href='https://developers.pismo.io/pismo-docs/docs/card-tokenization-flow-and-events' target='_blank'>Cards tokenization flow and events</a> guide for more information.",
    "properties": {
        "account_id": {
            "type": [
                "integer",
                "null"
            ],
            "title": "Accound ID",
            "description": "Pismo account ID.",
            "examples": [
                24146066
            ]
        },
        "card_id": {
            "title": "Card ID",
            "description": "Pismo card ID",
            "type": "integer",
            "examples": [
                42488842
            ]
        },
        "network_call_method": {
            "title": "Network call method",
            "description": "Network outbound method identifier, serves to parse raw message from network_data",
            "type": "string",
            "enum": [
                "VTS_STATUS_UPDATED_TOKEN_DEACTIVATED",
                "VTS_STATUS_UPDATED_TOKEN_SUSPEND",
                "VTS_STATUS_UPDATED_TOKEN_RESUME",
                "VTS_STATUS_UPDATED_OTP_VERIFICATION_RESULT",
                "VTS_STATUS_UPDATED_TOKEN_DEVICE_BINDING_REMOVED",
                "VTS_STATUS_UPDATED_CALL_CENTER_ACTIVATION",
                "VTS_STATUS_UPDATED_CARDHOLDER_STEPUP_RESULT",
                "VTS_STATUS_UPDATED_LUK_REPLENISHMENT",
                "VTS_STATUS_UPDATED_DEVICE_PROVISIONING_RESULT",
                "VTS_TOKEN_ACTIVATION_STIP",
                "VTS_TOKEN_CREATED",
                "VTS_APPROVE_PROVISIONING",
                "VTS_APPROVE_PROVISIONING_ISO",
                "VTS_GET_CVM",
                "VTS_DEVICE_BINDING",
                "VTS_PASSCODE",
                "TE",
                "TA",
                "AC",
                "TC",
                "TV"
            ]
        },
        "network_data": {
            "title": "Network data",
            "description": "Raw data from network. Varies according to flow and network brand",
            "type": "object"
        },
        "token_id": {
            "title": "Token ID",
            "description": "Pismo-created token ID.",
            "type": "integer",
            "examples": [
                42488842,
                93827266
            ]
        },
        "send_challenge": {
            "title": "Send Challenge",
            "description": "The object should be present when issuer it is responsible for sending OTP challenge to issuer.",
            "type": [
                "object",
                "null"
            ],
            "properties": {
                "otp_value": {
                    "title": "The OTP value",
                    "description": "issuer must send this value to cardholder using the chosen otp_method",
                    "type": "string",
                    "examples": [
                        "123456"
                    ]
                },
                "otp_method": {
                    "title": "One time passcode method",
                    "description": "OTP (one-time passcode) challenge customer selected for token provisioning.",
                    "type": "string",
                    "examples": [
                        "OTPSMS",
                        "OTPEMAIL"
                    ]
                }
            }
        },
        "pismo_response": {
            "title": "Pismo response",
            "description": "Pismo response to payment network. Response depends on network payment and `network_call_method`. Logs the final response from Pismo to the network payment. Should be null in async network calls that expect null values.",
            "additionalProperties": true,
            "type": [
                "object",
                "null"
            ],
            "examples": [
                {
                    "actionCode": "85",
                    "cvv2ResultsCode": "M"
                }
            ]
        }
    },
    "required": [
        "account_id",
        "card_id",
        "network_call_method",
        "network_data"
    ]
}