Upsert transaction

post

https://api.justt.ai/v1/transactions

Creates or updates a transaction record for additional purchases or activities made by a customer who has an existing chargeback case. This helps provide additional context for dispute resolution.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Transaction data to be created or updated in the system

transactionId

string

required

A unique transaction Identifier set by the PSP

transactionPsp

string

enum

The PSP that processed this transaction. Defaults to "other" when not provided

transactionCardLastFourDigits

string

The last 4 digits of the card used for this transaction

transactionCardAppleLast4Digits

string

The last four digit of the card when using apple pay

transactionCardScheme

string

The name of the card scheme

transactionCardBin

string

Bank Identification Number - a 6 or 8 digits identifier unique to each issuing bank

transactionCustomerDisplayedTransactionDescription

string

The name of the merchant as displayed to the buyer on their bank/credit card statement

transactionCardFingerprint

string

Unique identifier for a particular card number

transactionCreatedDate

string

The timestamp the transaction was processed

transactionStatus

string

The status of the transaction

transactionEarlyFraudWarningFraudType

string

A description of the fraud that is reported by the issuer

transactionVerificationCustomerPicture

string

A link to a picture of the customer

transactionArn

string

A unique number assigned to a credit card transaction by the merchant's bank as it moves through the PSP and the card scheme to the cardholder bank

transactionOrderIpAddress

string

The IP address of the customer at the time of purchase (checkout)

transactionOrderDeviceId

string

A unique identifier assigned to a device. Usually a string of alphanumeric characters

transactionOrderUserAgent

string

The browser or application identifier string that indicates what device and software were used by the cardholder for checkout

transactionOrderEmail

string

The customer's email address

transactionShippingToAddressLine1

string

First line of the shipping address

transactionShippingToAddressLine2

string

Second line of the shipping address

transactionShippingToState

string

The two–letter state abbreviation of the shipping address

transactionShippingToZipCode

string

The Zip code of the shipping address

transactionBillingAddressCountry

string

The country of the billing address

transactionShippingToFullShippingAddress

string

Any of following combined into one string: Address line 1, Address line 2, Shipping - City, Shipping - Zip, Shipping - State, Shipping - Country Name

transactionOrderSteamId

string

A unique account identifier for the cardholder's account in the merchants system

transactionOrderPhone

string

The customer's phone number

transactionShippingPhone

string

The phone number of the person the item was sent to according to the shipping detail the customer entered during the checkout

transactionShippingEmail

string

The email address of the person the item was sent to according to the shipping details the customer entered during the checkout

transactionOrderItemsProductName

string

The name of the product or service that was purchased

transactionOrderItemsProductDescription

string

A description of the product or service that was purchased

transactionOrderPurchaseCategory

string

Nature of the purchase (e.g. goods, service or digital)

transactionOrderNumber

string

The merchant's order reference number

transactionOrderInvoice

string

Invoice reference for the order

transactionOrderSubTotalPrice

number

Order amount before tax and shipping

transactionOrderTaxAmount

number

Tax amount charged on the order

transactionOrderDeviceType

string

Type of device used to place the order

transactionOrderDeviceName

string

Name of the device used to place the order

transactionOrderDeviceFingerprint

string

Unique fingerprint of the device used at order time

transactionOrderItemsProductType

string

Category/type of the purchased item

transactionOrderItemsProductUrl

string

Link to the purchased item

transactionOrderItemsArtistOrSeller

string

Marketplace seller or artist of the item

transactionOrderItemsProductPriceValue

number

Unit price of the purchased item

transactionOrderItemsProductQuantity

number

Quantity of the item purchased

transactionPaymentMethod

string

How the customer paid

transactionBillingBillingFullName

string

Full name on the payment / billing

transactionBillingAddressAddressLine1

string

Billing address line 1

transactionBillingAddressAddressLine2

string

Billing address line 2

transactionBillingAddressCity

string

Billing address city

transactionBillingAddressState

string

Billing address state / region

transactionBillingAddressZipCode

string

Billing address postal code

transactionBillingFirstName

string

Customer first name (billing)

transactionBillingLastName

string

Customer last name (billing)

transactionBillingEmail

string

Customer email address (billing)

transactionVerificationWasCvvProvided

boolean

Whether the CVV was provided / verified for the transaction

transactionCustomerCustomerId

string

The customer's account identifier in the merchant system

transactionCustomerAccountCreatedDaysAgo

number

Days since the customer account was created (length of relationship)

transactionShippingCompany

string

Shipping carrier

transactionShippingTrackingCode

string

Shipment tracking number

transactionShippingDate

string

Date the item was shipped

transactionShippingDeliveryDate

string

Date the item was delivered

transactionShippingStatus

string

Delivery status of the shipment

transactionShippingFirstName

string

Recipient first name

transactionShippingLastName

string

Recipient last name

Headers

reference-account-id

string

If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)

Responses

201Returns success if the transaction data was stored successfully

400In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed

404In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed

500In the message you can find explanation of what went wrong, please provide the error ID for our support for future investigation if needed