Authorization timeline event added

Authorization event added to user's timeline. For more information, see Timeline events overview.

Type: object
Domain: timeline
Event: authorization_authorize
Version: 1

|
id required

Title: Internal authorization ID
Type: integer
Example:
12345678

account_id required

Title: User's account ID at Pismo Platform
Type: integer
Example:
12345678

card_name

Title: Printed name on card
Type: string
Example:
HOMER SIMPSON

card_type

Title: Card type used in authorization
Type: string
Example:
PLASTIC
VIRTUAL

card_id

Title: Card id used in authorization
Type: integer
Example:
12345678

cardholder_currency_rate

Title: Factor used in the conversion from transaction to cardholder billing amount
Type: number
Example:
0.1933263

cardholderbilling_amount required

Title: Indicates the transaction amount in the issuer’s currency
Type: number
Example:
108.711498

contract_amount required

Title: Total amount of the transaction, including all taxes and fees, in the cardholder currency
Type: number
Example:
115.651498

currency_code required

Title: Currency code of the place where the transaction was done. ISO_4217 numeric code
Type: string
Example:
840
986

currency_literal

Title: Currency code country iso code. ISO3166-1 literal 3-digit code
Type: string
Example:
USD
BRL

customer_id required

Title: Customer id used in authorization
Type: integer
Example:
12345678

entry_mode required

Title: Indicates which entry mode code was used in the transaction
Type: string
Example:
01
05

entry_mode_literal

Title: Indicates the name of the entry mode used in the transaction
Type: string
Example:
MANUAL
CHIP

installment_amount required

Title: Installment amount of the authorization
Type: number
Example:
108.711498

installments required

Title: List of installments of this authorization
Type: array

amount required

Title: Installment amount
Type: number
Example:
108.711498

date required

Title: Installment date
Type: string
Example:
2020-01-28

interest_rate required

Title: Contains the rate that the issuer assesses the cardholder for the installment payment
Type: number
Example:
null

is_referral

Title: Indicates whether the transaction is suspected of fraud
Type: boolean

local_amount required

Title: Amount of funds the cardholder requested in the local currency of the acquirer or source location of the transaction
Type: number
Example:
24.99

merchant_category_code required

Title: Identifies the card acceptor that defines the point of the transaction in both local and interchange environments
Type: string
Example:
0000

merchant_category_group

Title: Mapped group based on category code
Type: string
Example:
RETAIL

merchant_city

Title: City field from merchant
Type: string
Example:
NEW YORK

merchant_state_or_country

Title: State or country field from merchant
Type: string
Example:
USA

tid

Title: Transaction identifier received on the authorization message.
Description: This identifier is generated by the Card Network. It will be null in case where the card network doesn't send this value.
Type: string or null
Example:
10119031908214800419
10219040207333200054

network required

Title: Network brand name
Type: string
Example:
Mastercard
Visa

number_of_installments required

Title: Number of installments in authorization
Type: integer
Example:
1
10
12

org_operation required

Title: Includes the processing code of the authorization
Type: object

processing_code required

Title: Describes the effect of a transaction on the customer account and the type of accounts affected
Type: string
Example:
000000

pre_authorization required

Title: Define whether it is a pre-authorization request or not
Type: boolean
Example:
true

principal_amount required

Title: Amount of transaction without taxes and fees
Type: number
Example:
108.711498

response_code required

Title: Defines the disposition of a previous message or an action taken as a result of receipt of a previous message
Type: string
Example:
00

settlement_currency_amount

Title: Amount of funds to be transferred between the acquirer and the issuer equal to the transaction amount in the settlement currency
Type: number
Example:
24.99

settlement_currency_code

Title: Currency code defined by the issuer
Type: string or null
Example:
840
986

settlement_currency_literal

Title: Currency code country description for settlement
Type: string or null
Example:
USD
BRL

settlement_currency_rate

Title: Factor used in the conversion from transaction to settlement amount
Type: number
Example:
0.1955

soft_descriptor

Title: Merchant description including name, city and country code
Type: string
Example:
MOE'S BAR

to_name

Type: string
Example:
MOE'S BAR

nsu

Title: Message initiator assigns to uniquely identify a transaction
Type: string
Example:
000001

retrieval_reference_number

Title: Document reference number assigned by the acquirer
Type: string
Example:
085000100001

authorization_code

Title: Transaction response ID code assigned by authorizing institution
Type: string
Example:
ABC123

ledger_update_id

Title: Id of update performed on Ledger API
Description: Id returned by the Ledger API which identifies the account limit impact. This field may be null since some transactions generate timeline but doesn't have any financial impact.
Type: string or null
Example:
dc123453-4444-1111-9999-53699d123456

card_acceptor_id

Title: Identifies the card acceptor that defines the point of the transaction in both local and interchange environments
Type: string
Example:
013335009996001

airport_tax

Title: Amount of airport tax on the authorization
Type: number or null
Example:
109.14

cash_back_amount

Title: Amount of Cash Back of the Authorization
Description: In purchase with cash back or POS withdrawal, this is the amount related to the withdrawal/cash back. The principal amount is the sum of this amount with the purchase amount.
Type: number
Example:
200

token_information

Title: Token information for tokenized authorizations
Description: Contains information of the token which did authenticate authorization
Type: object or null

id

Title: Token ID
Description: The sequential internal identifier that is generated automatically
Type: null or integer
Example:
17084
17085

requestor_id

Title: Requestor ID
Description: A string that identifies the wallet which request the token provisioning
Type: null or string
Example:
APPLE_PAY
GOOGLE_PAY

type

Title: Token Type
Description: A string that identifies the type of the token
Type: null or string
Example:
CARD_ON_FILE
EMBEDDED_SECURE_ELEMENT

network_token

Title: Network Token
Description: Token identifier as coming from the network. For Visa requests, this field represents the value received in the F123, Usage 2, Dataset ID 68 (Token Data), Tag 01. For Mastercard requests, it is DE48, SE 33 PanMappingFileInformation, SF2 Account Number.
Type: null or string
Example:
17084
17085

network_requestor_id

Title: Network Requestor ID
Description: A string that identifies the wallet which request the token provisioning, as coming from the network. For Visa requests, this field represents the value received in the F123, Usage 2, Dataset ID 68 (Token Data), Tag 03. For Mastercard requests, it is DE48, SE 33 PanMappingFileInformation, SF6 Token Requestor ID.
Type: null or string
Example:
40010043095
40010083219

mti

Title: Message Type Identifier
Description: Indicates the type of message.
Type: string
Example:
0100

cancelled_by_elapsed_time

Title: Cancelled by Elapsed Time
Description: This flag indicates whether a authorization was cancelled because of the elapsed time without a confirmation message. If so, its value will be 'true'. If the authorization was cancelled by the acquirer, its value will be false. For events other than Cancellation timelines, its value will be 'null'.
Type: boolean or null
Example:
true
false
null

metadata

Title: Metadata from Anti Fraud
Description: Contains any valid json sent into the response of the Anti Fraud request. This information is saved and sent into this event as it was received into the platform, without any processing over it.
Type: object or null

validation_results

Type: array or null
Additional properties: false

name required

Title: Validation name
Description: The name which identifies the validation.
Type: string
Example:
CVV2_INVALID
EXPIRATION_DATE_INVALID
ARQC_SIGNATURE_VALID

status required

Title: Validation status
Description: Represents the result of the validation.
Type: string
Must be one of the following:
SKIPPED
APPROVED
REJECTED

reason required

Title: Validation reason
Description: Identifies the reason why a validation has that result.
Type: null or string
Example:
TERMINAL_CAPABILITY_VALID
PIN_AND_CVV_VALID

description required

Title: Description
Description: Contains a more detailed information about the validation result.
Type: string
Example:
TERMINAL_CAPABILITY_VALID
PIN_AND_CVV_VALID

additional_data

Title: Additional Data
Description: Contains additional information that is relevant to identify how the validation was performed. Every validation will have its own additional data, so please refer to Pismo Developers Guide to identify every possibility.
Type: object or null

dcc

Title: Flag indicating a DCC authorization
Description: This flag identifies if an authorization is DCC. This flag is true when the local amount is in the cardholder currency but the Merchant is International. It identifies that even though the authorization is in the local currency, it was considered an International authorization.
Type: boolean or null
Example:
true
false
null

incoming_response_code

Title: Incoming Response Code from Card Network
Description: This field represents the value received in the field 39 of the Card Network specification and indicates the Response Code they assigned to this authorization. For cancellation messages, if present, this value may indicate the reason of the cancellation.
Type: string or null
Example:
00
05

incoming_authorization_code

Title: Incoming Authorization Code from Card Network
Description: This field represents the value received in the field 38 of the Card Network specification and indicates the Authorization Code they assigned to this authorization.
Type: string or null
Example:
00
05

origin

Description: The origin used in migrations.
Type: string
Example:
STRIKER
MIGRATION
null

program_id

Title: Program ID used in the authorization.
Description: This field represents the internal id of the Program of the card used on this authorization.
Type: integer
Example:
82
93
131

{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "title": "Authorization timeline event added",
    "description": "Authorization event added to user's timeline. For more information, see [Timeline events overview](https://developers.pismo.io/pismo-docs/docs/timeline-overview).",
    "required": [
        "id",
        "account_id",
        "cardholderbilling_amount",
        "contract_amount",
        "currency_code",
        "customer_id",
        "entry_mode",
        "installment_amount",
        "installments",
        "interest_rate",
        "local_amount",
        "merchant_category_code",
        "network",
        "number_of_installments",
        "org_operation",
        "pre_authorization",
        "principal_amount",
        "response_code"
    ],
    "properties": {
        "id": {
            "type": "integer",
            "title": "Internal authorization ID",
            "examples": [
                12345678
            ]
        },
        "account_id": {
            "type": "integer",
            "title": "User's account ID at Pismo Platform",
            "default": 0,
            "examples": [
                12345678
            ]
        },
        "card_name": {
            "type": "string",
            "title": "Printed name on card",
            "examples": [
                "HOMER SIMPSON"
            ]
        },
        "card_type": {
            "type": "string",
            "title": "Card type used in authorization",
            "examples": [
                "PLASTIC",
                "VIRTUAL"
            ]
        },
        "card_id": {
            "type": "integer",
            "title": "Card id used in authorization",
            "examples": [
                12345678
            ]
        },
        "cardholder_currency_rate": {
            "type": "number",
            "title": "Factor used in the conversion from transaction to cardholder billing amount",
            "examples": [
                0.1933263
            ]
        },
        "cardholderbilling_amount": {
            "type": "number",
            "title": "Indicates the transaction amount in the issuer\u2019s currency",
            "examples": [
                108.711498
            ]
        },
        "contract_amount": {
            "type": "number",
            "title": "Total amount of the transaction, including all taxes and fees, in the cardholder currency",
            "examples": [
                115.651498
            ]
        },
        "currency_code": {
            "type": "string",
            "title": "Currency code of the place where the transaction was done. ISO_4217 numeric code",
            "examples": [
                "840",
                "986"
            ]
        },
        "currency_literal": {
            "type": "string",
            "title": "Currency code country iso code. ISO3166-1 literal 3-digit code",
            "examples": [
                "USD",
                "BRL"
            ]
        },
        "customer_id": {
            "type": "integer",
            "title": "Customer id used in authorization",
            "examples": [
                12345678
            ]
        },
        "entry_mode": {
            "type": "string",
            "title": "Indicates which entry mode code was used in the transaction",
            "examples": [
                "01",
                "05"
            ]
        },
        "entry_mode_literal": {
            "type": "string",
            "title": "Indicates the name of the entry mode used in the transaction",
            "examples": [
                "MANUAL",
                "CHIP"
            ]
        },
        "installment_amount": {
            "type": "number",
            "title": "Installment amount of the authorization",
            "examples": [
                108.711498
            ]
        },
        "installments": {
            "type": "array",
            "title": "List of installments of this authorization",
            "items": {
                "type": "object",
                "title": "Installment information",
                "required": [
                    "amount",
                    "date"
                ],
                "properties": {
                    "amount": {
                        "type": "number",
                        "title": "Installment amount",
                        "examples": [
                            108.711498
                        ]
                    },
                    "date": {
                        "type": "string",
                        "title": "Installment date",
                        "examples": [
                            "2020-01-28"
                        ]
                    }
                }
            }
        },
        "interest_rate": {
            "type": "number",
            "title": "Contains the rate that the issuer assesses the cardholder for the installment payment",
            "examples": [
                0
            ]
        },
        "is_referral": {
            "type": "boolean",
            "title": "Indicates whether the transaction is suspected of fraud"
        },
        "local_amount": {
            "type": "number",
            "title": "Amount of funds the cardholder requested in the local currency of the acquirer or source location of the transaction",
            "examples": [
                24.99
            ]
        },
        "merchant_category_code": {
            "type": "string",
            "title": "Identifies the card acceptor that defines the point of the transaction in both local and interchange environments",
            "examples": [
                "0000"
            ]
        },
        "merchant_category_group": {
            "type": "string",
            "title": "Mapped group based on category code",
            "examples": [
                "RETAIL"
            ]
        },
        "merchant_city": {
            "type": "string",
            "title": "City field from merchant",
            "examples": [
                "NEW YORK"
            ]
        },
        "merchant_state_or_country": {
            "type": "string",
            "title": "State or country field from merchant",
            "examples": [
                "USA"
            ]
        },
        "tid": {
            "type": [
                "string",
                "null"
            ],
            "title": "Transaction identifier received on the authorization message.",
            "description": "This identifier is generated by the Card Network. It will be null in case where the card network doesn't send this value.",
            "examples": [
                "10119031908214800419",
                "10219040207333200054"
            ]
        },
        "network": {
            "type": "string",
            "title": "Network brand name",
            "examples": [
                "Mastercard",
                "Visa"
            ]
        },
        "number_of_installments": {
            "type": "integer",
            "title": "Number of installments in authorization",
            "examples": [
                1,
                10,
                12
            ]
        },
        "org_operation": {
            "type": "object",
            "title": "Includes the processing code of the authorization",
            "required": [
                "processing_code"
            ],
            "properties": {
                "processing_code": {
                    "type": "string",
                    "title": "Describes the effect of a transaction on the customer account and the type of accounts affected",
                    "examples": [
                        "000000"
                    ]
                }
            }
        },
        "pre_authorization": {
            "type": "boolean",
            "title": "Define whether it is a pre-authorization request or not",
            "examples": [
                true
            ]
        },
        "principal_amount": {
            "type": "number",
            "title": "Amount of transaction without taxes and fees",
            "examples": [
                108.711498
            ]
        },
        "response_code": {
            "type": "string",
            "title": "Defines the disposition of a previous message or an action taken as a result of receipt of a previous message",
            "examples": [
                "00"
            ]
        },
        "settlement_currency_amount": {
            "type": "number",
            "title": "Amount of funds to be transferred between the acquirer and the issuer equal to the transaction amount in the settlement currency",
            "examples": [
                24.99
            ]
        },
        "settlement_currency_code": {
            "type": [
                "string",
                "null"
            ],
            "title": "Currency code defined by the issuer",
            "examples": [
                "840",
                "986"
            ]
        },
        "settlement_currency_literal": {
            "type": [
                "string",
                "null"
            ],
            "title": "Currency code country description for settlement",
            "examples": [
                "USD",
                "BRL"
            ]
        },
        "settlement_currency_rate": {
            "type": "number",
            "title": "Factor used in the conversion from transaction to settlement amount",
            "examples": [
                0.1955
            ]
        },
        "soft_descriptor": {
            "type": "string",
            "title": "Merchant description including name, city and country code",
            "examples": [
                "MOE'S BAR           "
            ]
        },
        "to_name": {
            "type": "string",
            "title": "",
            "examples": [
                "MOE'S BAR"
            ]
        },
        "nsu": {
            "type": "string",
            "title": "Message initiator assigns to uniquely identify a transaction",
            "examples": [
                "000001"
            ]
        },
        "retrieval_reference_number": {
            "type": "string",
            "title": "Document reference number assigned by the acquirer",
            "examples": [
                "085000100001"
            ]
        },
        "authorization_code": {
            "type": "string",
            "title": "Transaction response ID code assigned by authorizing institution",
            "examples": [
                "ABC123"
            ]
        },
        "ledger_update_id": {
            "type": [
                "string",
                "null"
            ],
            "title": "Id of update performed on Ledger API",
            "description": "Id returned by the Ledger API which identifies the account limit impact. This field may be null since some transactions generate timeline but doesn't have any financial impact.",
            "examples": [
                "dc123453-4444-1111-9999-53699d123456"
            ]
        },
        "card_acceptor_id": {
            "type": "string",
            "title": "Identifies the card acceptor that defines the point of the transaction in both local and interchange environments",
            "examples": [
                "013335009996001"
            ]
        },
        "airport_tax": {
            "type": [
                "number",
                "null"
            ],
            "title": "Amount of airport tax on the authorization",
            "examples": [
                109.14
            ]
        },
        "cash_back_amount": {
            "type": "number",
            "title": "Amount of Cash Back of the Authorization",
            "description": "In purchase with cash back or POS withdrawal, this is the amount related to the withdrawal/cash back. The principal amount is the sum of this amount with the purchase amount.",
            "examples": [
                200
            ]
        },
        "token_information": {
            "type": [
                "object",
                "null"
            ],
            "title": "Token information for tokenized authorizations",
            "description": "Contains information of the token which did authenticate authorization",
            "properties": {
                "id": {
                    "type": [
                        "null",
                        "integer"
                    ],
                    "title": "Token ID",
                    "description": "The sequential internal identifier that is generated automatically",
                    "examples": [
                        17084,
                        17085
                    ]
                },
                "requestor_id": {
                    "type": [
                        "null",
                        "string"
                    ],
                    "title": "Requestor ID",
                    "description": "A string that identifies the wallet which request the token provisioning",
                    "examples": [
                        "APPLE_PAY",
                        "GOOGLE_PAY"
                    ]
                },
                "type": {
                    "type": [
                        "null",
                        "string"
                    ],
                    "title": "Token Type",
                    "description": "A string that identifies the type of the token",
                    "examples": [
                        "CARD_ON_FILE",
                        "EMBEDDED_SECURE_ELEMENT"
                    ]
                },
                "network_token": {
                    "type": [
                        "null",
                        "string"
                    ],
                    "title": "Network Token",
                    "description": "Token identifier as coming from the network. For Visa requests, this field represents the value received in the F123, Usage 2, Dataset ID 68 (Token Data), Tag 01. For Mastercard requests, it is DE48, SE 33 PanMappingFileInformation, SF2 Account Number.",
                    "examples": [
                        "17084",
                        "17085"
                    ]
                },
                "network_requestor_id": {
                    "type": [
                        "null",
                        "string"
                    ],
                    "title": "Network Requestor ID",
                    "description": "A string that identifies the wallet which request the token provisioning, as coming from the network. For Visa requests, this field represents the value received in the F123, Usage 2, Dataset ID 68 (Token Data), Tag 03. For Mastercard requests, it is DE48, SE 33 PanMappingFileInformation, SF6 Token Requestor ID.",
                    "examples": [
                        "40010043095",
                        "40010083219"
                    ]
                }
            }
        },
        "mti": {
            "type": "string",
            "title": "Message Type Identifier",
            "description": "Indicates the type of message.",
            "examples": [
                "0100"
            ]
        },
        "cancelled_by_elapsed_time": {
            "type": [
                "boolean",
                "null"
            ],
            "title": "Cancelled by Elapsed Time",
            "description": "This flag indicates whether a authorization was cancelled because of the elapsed time without a confirmation message. If so, its value will be 'true'. If the authorization was cancelled by the acquirer, its value will be false. For events other than Cancellation timelines, its value will be 'null'.",
            "examples": [
                true,
                false,
                null
            ]
        },
        "metadata": {
            "title": "Metadata from Anti Fraud",
            "description": "Contains any valid json sent into the response of the Anti Fraud request. This information is saved and sent into this event as it was received into the platform, without any processing over it.",
            "type": [
                "object",
                "null"
            ]
        },
        "validation_results": {
            "title": "Validation results",
            "description": "Contains all executed validations with details for each result.",
            "type": [
                "array",
                "null"
            ],
            "items": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                    "name": {
                        "title": "Validation name",
                        "description": "The name which identifies the validation.",
                        "type": [
                            "string"
                        ],
                        "examples": [
                            "CVV2_INVALID",
                            "EXPIRATION_DATE_INVALID",
                            "ARQC_SIGNATURE_VALID"
                        ]
                    },
                    "status": {
                        "title": "Validation status",
                        "description": "Represents the result of the validation.",
                        "type": [
                            "string"
                        ],
                        "enum": [
                            "SKIPPED",
                            "APPROVED",
                            "REJECTED"
                        ]
                    },
                    "reason": {
                        "title": "Validation reason",
                        "description": "Identifies the reason why a validation has that result.",
                        "type": [
                            "null",
                            "string"
                        ],
                        "examples": [
                            "TERMINAL_CAPABILITY_VALID",
                            "PIN_AND_CVV_VALID"
                        ]
                    },
                    "description": {
                        "title": "Description",
                        "description": "Contains a more detailed information about the validation result.",
                        "type": [
                            "string"
                        ],
                        "examples": [
                            "TERMINAL_CAPABILITY_VALID",
                            "PIN_AND_CVV_VALID"
                        ]
                    },
                    "additional_data": {
                        "title": "Additional Data",
                        "description": "Contains additional information that is relevant to identify how the validation was performed. Every validation will have its own additional data, so please refer to Pismo Developers Guide to identify every possibility.",
                        "type": [
                            "object",
                            "null"
                        ]
                    }
                },
                "required": [
                    "name",
                    "status",
                    "reason",
                    "description"
                ]
            }
        },
        "dcc": {
            "type": [
                "boolean",
                "null"
            ],
            "title": "Flag indicating a DCC authorization",
            "description": "This flag identifies if an authorization is DCC. This flag is true when the local amount is in the cardholder currency but the Merchant is International. It identifies that even though the authorization is in the local currency, it was considered an International authorization.",
            "examples": [
                true,
                false,
                null
            ]
        },
        "incoming_response_code": {
            "type": [
                "string",
                "null"
            ],
            "title": "Incoming Response Code from Card Network",
            "description": "This field represents the value received in the field 39 of the Card Network specification and indicates the Response Code they assigned to this authorization. For cancellation messages, if present, this value may indicate the reason of the cancellation.",
            "examples": [
                "00",
                "05"
            ]
        },
        "incoming_authorization_code": {
            "type": [
                "string",
                "null"
            ],
            "title": "Incoming Authorization Code from Card Network",
            "description": "This field represents the value received in the field 38 of the Card Network specification and indicates the Authorization Code they assigned to this authorization.",
            "examples": [
                "00",
                "05"
            ]
        },
        "origin": {
            "type": "string",
            "description": "The origin used in migrations.",
            "examples": [
                "STRIKER",
                "MIGRATION",
                "null"
            ]
        },
        "program_id": {
            "type": "integer",
            "title": "Program ID used in the authorization.",
            "description": "This field represents the internal id of the Program of the card used on this authorization.",
            "examples": [
                82,
                93,
                131
            ]
        }
    },
    "definitions": {}
}