Transactions

count

The number of transactions to retrieve.

1-10

start_index

The sort order index of the first resource in the returned array.

Any integer

fields

Comma-delimited list of fields to return (field_1,field_2, and so on). Leave blank to return all fields.

Comma-delimited list of fields, or blank

sort_by

Field on which to sort. Use any field in the resource model, or one of the system fields lastModifiedTime or createdTime. Prefix the field name with a hyphen (-) to sort in descending order. Omit the hyphen to sort in ascending order.

-created_time, created_time, -user_transaction_time, user_transaction_time

start_date

The starting date (or date-time) of a date range from which to return transactions. To return transactions for a single day, enter the same date in both the start_date and end_date fields.

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss.SS

end_date

The ending date (or date-time) of a date range from which to return transactions. To return transactions for a single day, enter the same date in both the end_date and start_date fields.

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss.SS

type

Comma-delimited list of transaction types to include.

account.credit, account.debit, balanceinquiry, authorization, authorization.advice, authorization.atm.withdrawal, authorization.cashback, authorization.clearing, authorization.clearing.atm.withdrawal, authorization.clearing.cashback, authorization.clearing.chargeback, authorization.clearing.chargeback.completed, authorization.clearing.chargeback.provisional.credit, authorization.clearing.chargeback.provisional.debit, authorization.clearing.chargeback.reversal, authorization.clearing.chargeback.writeoff, authorization.clearing.quasi.cash, authorization.incremental authorization.quasi.cash, authorization.reversal, authorization.reversal.issuerexpiration, authorization.standin, directdeposit.credit, directdeposit.credit.pending, directdeposit.credit.pending.reversal, directdeposit.credit.reject, directdeposit.credit.reversal, directdeposit.debit, directdeposit.debit.pending, directdeposit.debit.pending.reversal, directdeposit.debit.reject, directdeposit.debit.reversal, dispute.credit, dispute.debit, fee.charge.pending, fee.charge.reversal, fee.charge, fee.charge.pending.refund, funds.expire, gpa.credit, gpa.credit.authorization, gpa.credit.authorization.reversal, gpa.credit.pending, gpa.credit.pending.reversal, gpa.credit.reversal, gpa.credit.networkload, gpa.credit.networkload.reversal, gpa.debit.networkload, gpa.debit, gpa.debit.pending, gpa.debit.pending.reversal, gpa.debit.reversal, gpa.grant, gpa.credit.issueroperator, gpa.debit.issueroperator, gpa.credit.chargeback, gpa.credit.chargeback.reversal, gpa.credit.billpayment, gpa.credit.authorization.billpayment` gpa.credit.authorization.billpayment.reversal, original.credit.auth_plus_capture, original.credit.auth_plus_capture.reversal, original.credit.authorization, original.credit.authorization.clearing, original.credit.authorization.reversal, pindebit, pindebit.atm.withdrawal, pindebit.authorization, pindebit.authorization.clearing, pindebit.authorization.reversal, pindebit.authorization.reversal.issuerexpiration, pindebit.balanceinquiry, pindebit.cashback, pindebit.chargeback, pindebit.chargeback.completed, pindebit.chargeback.provisional.credit, pindebit.chargeback.provisional.debit, pindebit.chargeback.reversal, pindebit.chargeback.writeoff, pindebit.credit.adjustment, pindebit.quasi.cash, pindebit.refund, pindebit.refund.reversal, pindebit.reversal, pindebit.transfer, programreserve.credit, programreserve.debit, pushtocard.debit, pushtocard.reversal, refund, refund.authorization, refund.authorization.advice, refund.authorization.clearing, refund.authorization.reversal, token.activation-request, token.advice, transfer.peer, transfer.fee, transfer.program, unknown

user_token

The unique identifier of the user account holder.

Existing user token

business_token

The unique identifier of the business account holder.

Existing business token

acting_user_token

The unique identifier of the acting user.

Existing user token

card_token

The unique identifier of the card.

Existing card token

state

Comma-delimited list of transaction states to display.

PENDING, CLEARED, COMPLETION, DECLINED, ERROR, ALL

version

Specifies the API version for the request.

v1, v2, v3

verbose

If true, the query returns additional information for diagnostic purposes.

true, false

count

The number of resources to retrieve.

1-10

data

An array of transaction objects.

One or more transaction objects

data[].acquirer

Contains information about the merchant’s financial institution.

Existing acquirer object

data[].acquirer.institution_country

Country code of the merchant’s financial institution.

Valid alpha-3 ISO 3166 country code

data[].acquirer.institution_id_code

Identifier code of the merchant’s financial institution.

255 char max

data[].acquirer.network_international_id

The international network identifier.

255 char max

data[].acquirer.retrieval_reference_number

Retrieval reference number of the merchant’s financial institution.

255 char max

data[].acquirer.system_trace_audit_number

System trace audit number of the merchant’s financial institution.

255 char max

data[].acquirer_fee_amount

Indicates the amount of the acquirer fee. Account holders are sometimes charged an acquirer fee for card use at ATMs, fuel dispensers, and so on.

Format: 0.00

data[].acquirer_reference_id

Acquirer-assigned unique identifier of the transaction. Useful for settlement and reconciliation.

255 char max

data[].acting_user_token

Unique identifier of the user who conducted the transaction. This might be a child user configured to share its parent’s account balance.

36 char max

data[].address_verification

Contains address verification data consisting of address data entered by the cardholder, address data held by the Marqeta platform, and an assertion by the Marqeta platform as to whether the two sets of data match.

Existing address_verification object

data[].address_verification.on_file

Contains address verification information provided by the cardholder or held on file by Marqeta.

Existing address verification information

data[].address_verification.on_file.postal_code

Postal code provided by the Marqeta platform.

10 char max

data[].address_verification.on_file.street_address

Street address provided by the cardholder.

40 char max

data[].address_verification.on_file.zip

ZIP code provided by the cardholder.

10 char max

data[].address_verification.request

Contains address verification information provided by the cardholder or held on file by Marqeta.

Existing address verification information

data[].address_verification.request.postal_code

Postal code provided by the Marqeta platform.

10 char max

data[].address_verification.request.street_address

Street address provided by the cardholder.

40 char max

data[].address_verification.request.zip

ZIP code provided by the cardholder.

10 char max

data[].address_verification.response

Contains information about the response, including the response code and response memo.

Existing response object

data[].address_verification.response.additional_information

Information about the relevant velocity control for the transaction, if applicable.

The additional_information field returns a string in the following format: <Velocity control name>, cumulative transaction amount is <X>, where X is the cumulative transaction amount value calculated by Marqeta. For example: 500 max spend per day, cumulative transaction amount is 750.

data[].address_verification.response.code

Four-digit code corresponding to the outcome of the attempted transaction.

card_security_code_verification.response.code indicates whether the verification check passed. It can have these possible values:

Four digits

data[].address_verification.response.memo

Information on the outcome of the attempted transaction.

255 char max

data[].amount

Amount of the transaction.

Format: 0.00

data[].amount_to_be_released

Amount to release following a financial advice.

Format: 0.00

data[].approval_code

Unique identifier assigned to an authorization, printed on the receipt at point of sale.

255 char max

data[].auto_reload

Contains information about an auto reload. See Auto Reloads for more information.

Returned if an auto reload was executed.

Existing auto_reload object

data[].auto_reload.active

Whether the auto reload is active.

Only one auto reload per level, per object, can be active.

true, false

data[].auto_reload.association

Contains the scope of the auto reload: card product, user, or business.

If no value is supplied, the auto reload applies at the program level.

Existing auto_reload_association object

data[].auto_reload.association.business_token

Unique identifier of the associated business.

1–36 chars

data[].auto_reload.association.card_product_token

Unique identifier of the associated card product.

1–36 chars

data[].auto_reload.association.user_token

Unique identifier of the associated user.

1–36 chars

data[].auto_reload.currency_code

Currency of the funds used in the auto reload.

Valid three-digit ISO 4217 currency code

data[].auto_reload.funding_source_address_token

Unique identifier of the associated funding source address used for the auto reload.

Returned when the funding source is a payment card.

1–36 chars

data[].auto_reload.funding_source_token

Unique identifier of the associated funding source used for the auto reload.

Returned when order_scope contains the gpa object.

1–36 chars

data[].auto_reload.order_scope

Defines the balance threshold and reload amounts.

A valid order_scope object

data[].auto_reload.order_scope.gpa

Contains information about the GPA order. See GPA Orders for more information.

Existing gpa object

data[].auto_reload.order_scope.gpa.reload_amount

Available balance on the card after the reload has completed.

This value must be greater than or equal to the value of trigger_amount. Note that this is not the same as the amount added to the card, which will vary from reload to reload.

0.01 min

data[].auto_reload.order_scope.gpa.trigger_amount

Threshold that determines when the reload happens.

The reload is triggered when the balance drops below this amount.

0.01 min

data[].auto_reload.token

Unique identifier of the auto reload.

1–36 chars

data[].batch_number

The batch number of the transaction.

255 char max

data[].business

Contains customer-provided information about the business that funded the transaction.

Existing business metadata

data[].business.metadata

Associates customer-provided metadata with the business.

Up to 20 name-value pair fields in "field_name_1": "field_value_1" format.

data[].business_token

Unique identifier of the business that owns the account that funded the transaction.

36 char max

data[].card

Contains information about the card used in the transaction.

Existing card_response object

data[].card.activation_actions

Defines actions to execute when the card is activated.

Existing activation_actions object

data[].card.activation_actions.swap_digital_wallet_tokens_from_card_token

Moves all digital wallet tokens from the specified card to the new card.

Not relevant when reissue_pan_from_card_token is set.

1–36 chars

data[].card.activation_actions.terminate_reissued_source_card

Whether or not the source card from which the card was reissued should be terminated.

true, false

data[].card.barcode

The barcode printed on the card, expressed as numerals.

10-20 digits

data[].card.bulk_issuance_token

The unique identifier of the bulk card order.

Existing bulk_issuance token

data[].card.card_product_token

Unique identifier of the card product.

Existing card product token

data[].card.chip_cvv_number

Three-digit card verification value (CVV2) included on the back of the card.

3 digits

data[].card.contactless_exemption_counter

A running count of contactless transactions. You can limit the number of contactless transactions that can be performed without issuing a strong customer authentication (SCA) challenge at the card product level.

For more information about strong customer authentication, see Card Products.

Any integer

data[].card.contactless_exemption_total_amount

A running total of funds spent in contactless transactions. You can limit the total amount that can be spent in contactless transactions without issuing a strong customer authentication (SCA) challenge at the card product level.

For more information about strong customer authentication, see Card Products.

Any integer

data[].card.created_time

Date and time when the card was created.

Format: yyyy-MM-ddThh:mm:ssZ

data[].card.cvv_number

Three-digit card verification value (CVV2) of the chip, included on the back of the card.

3 char max

data[].card.expedite

Whether to expedite the card fulfillment order.

true, false

data[].card.expiration

Month and year when the card expires.

Format: MM-YY

data[].card.expiration_time

Date and time when the card expires.

Format: yyyy-MM-ddThh:mm:ssZ

data[].card.fulfillment

Specifies certain physical characteristics of a card, as well as shipment information.

Existing fulfillment object

data[].card.fulfillment.card_fulfillment_reason

Specifies the reason for card fulfillment.

NEW, LOST_STOLEN, EXPIRED

data[].card.fulfillment.card_personalization

Allows personalized attributes to be added to the card.

Existing card_personalization object

data[].card.fulfillment.card_personalization.carrier

Contains attributes of the card carrier.

Existing carrier object

data[].card.fulfillment.card_personalization.carrier.logo_file

Image to display on the card carrier.

Existing image file name

data[].card.fulfillment.card_personalization.carrier.logo_thumbnail_file

Specifies a thumbnail-sized rendering of the image specified in the logo_file field.

Existing image file name

data[].card.fulfillment.card_personalization.carrier.message_file

Specifies a text file containing a custom message to print on the card carrier.

Existing text file name

data[].card.fulfillment.card_personalization.carrier.message_line

Specifies a custom message that appears on the card carrier.

60 char max

data[].card.fulfillment.card_personalization.carrier.template_id

Card carrier template to use.

Existing card carrier template ID

data[].card.fulfillment.card_personalization.images

Specifies personalized images that appear on the card.

Existing images object

data[].card.fulfillment.card_personalization.images.card

Specifies personalized images that appear on the card.

Existing image_card object

data[].card.fulfillment.card_personalization.images.card.name

Specifies a PNG image to display on the card.

Existing image file name

data[].card.fulfillment.card_personalization.images.card.thermal_color

Specifies the color of the image displayed on the card.

Existing color name

data[].card.fulfillment.card_personalization.images.carrier

Specifies personalized images that appear on the card carrier.

Existing images_carrier object

data[].card.fulfillment.card_personalization.images.carrier.message_1

Specifies a custom message that appears on the card carrier.

60 char max

data[].card.fulfillment.card_personalization.images.carrier.name

Specifies a PNG image to display on the card carrier.

Contains the name of the image file and must match the name of the file you send to your fulfillment provider.

data[].card.fulfillment.card_personalization.images.carrier_return_window

Specifies a PNG image to display in the return address window of envelopes used for sending cards to cardholders.

Existing carrier_return_window object

data[].card.fulfillment.card_personalization.images.carrier_return_window.name

Specifies a PNG image to display in the return-address window of envelopes used for sending cards to cardholders.

Existing image file name

data[].card.fulfillment.card_personalization.images.signature

Specifies a PNG image of the cardholder’s signature.

Existing images_signature object

data[].card.fulfillment.card_personalization.images.signature.name

Specifies a PNG image of the cardholder’s signature.

Existing image file name

data[].card.fulfillment.card_personalization.perso_type

Specifies the method for printing personalized text on the card.

EMBOSS, LASER, FLAT

data[].card.fulfillment.card_personalization.text

Specifies personalized text that appears on the card.

Valid text object

data[].card.fulfillment.card_personalization.text.name_line_1

First line of personalized text printed on the card.

name_line1.value

data[].card.fulfillment.card_personalization.text.name_line_1.value

Specifies a line of personalized text that appears on the card.

21 char max; strings longer than 21 characters are truncated

data[].card.fulfillment.card_personalization.text.name_line_2

Second line of personalized text printed on the card.

name_line2.value

data[].card.fulfillment.card_personalization.text.name_line_2.value

Specifies a line of personalized text that appears on the card.

21 char max; strings longer than 21 characters are truncated

data[].card.fulfillment.card_personalization.text.name_line_3

Third line of personalized text printed on the card.

name_line3.value

data[].card.fulfillment.card_personalization.text.name_line_3.value

Specifies a line of personalized text that appears on the card.

21 char max; strings longer than 21 characters are truncated

data[].card.fulfillment.shipping

Specifies shipping details for the card.

Existing shipping object

data[].card.fulfillment.shipping.care_of_line

Person or entity to receive the card on behalf of the recipient.

255 char max

data[].card.fulfillment.shipping.method

Shipping company and shipping service level.

FEDEX_EXPEDITED, FEDEX_REGULAR, UPS_EXPEDITED, UPS_REGULAR, USPS_EXPEDITED, USPS_REGULAR

data[].card.fulfillment.shipping.recipient_address

Specifies a fulfillment shipping or return address.

Existing fulfillment_address_response object

data[].card.fulfillment.shipping.recipient_address.address1

Street address.

255 char max

data[].card.fulfillment.shipping.recipient_address.address2

Additional address information.

255 char max

data[].card.fulfillment.shipping.recipient_address.city

City.

40 char max

data[].card.fulfillment.shipping.recipient_address.country

Country.

40 char max

data[].card.fulfillment.shipping.recipient_address.first_name

First name.

40 char max

data[].card.fulfillment.shipping.recipient_address.last_name

Last name.

40 char max

data[].card.fulfillment.shipping.recipient_address.middle_name

Middle name.

40 char max

data[].card.fulfillment.shipping.recipient_address.phone

Phone number.

20 char max

data[].card.fulfillment.shipping.recipient_address.postal_code

Postal code.

10 char max

data[].card.fulfillment.shipping.recipient_address.state

State.

32 char max

data[].card.fulfillment.shipping.recipient_address.zip

ZIP code.

10 char max

data[].card.fulfillment.shipping.return_address

Specifies a fulfillment shipping or return address.

Existing fulfillment_address_response object

data[].card.fulfillment.shipping.return_address.address1

Street address.

255 char max

data[].card.fulfillment.shipping.return_address.address2

Additional address information.

255 char max

data[].card.fulfillment.shipping.return_address.city

City.

40 char max

data[].card.fulfillment.shipping.return_address.country

Country.

40 char max

data[].card.fulfillment.shipping.return_address.first_name

First name.

40 char max

data[].card.fulfillment.shipping.return_address.last_name

Last name.

40 char max

data[].card.fulfillment.shipping.return_address.middle_name

Middle name.

40 char max

data[].card.fulfillment.shipping.return_address.phone

Phone number.

20 char max

data[].card.fulfillment.shipping.return_address.postal_code

Postal code.

10 char max

data[].card.fulfillment.shipping.return_address.state

State.

32 char max

data[].card.fulfillment.shipping.return_address.zip

ZIP code.

10 char max

data[].card.fulfillment_status

Status of the card fulfillment.

ISSUED, ORDERED, REORDERED, REJECTED, SHIPPED, DELIVERED, DIGITALLY_PRESENTED

data[].card.instrument_type

The instrument type of the card:

PHYSICAL_MSR, PHYSICAL_ICC, PHYSICAL_CONTACTLESS, PHYSICAL_COMBO, VIRTUAL_PAN

data[].card.last_four

Last four digits of the card PAN.

4 digits

data[].card.last_modified_time

Date and time when the card was last modified.

Format: yyyy-MM-ddThh:mm:ssZ

data[].card.metadata

Associates customer-provided metadata with the card.

Up to 20 name-value pair fields in "field_name_1": "field_value_1" format.

data[].card.pan

Full primary account number (PAN) of the card.

Existing card PAN.

data[].card.pin_is_set

Specifies if a PIN was set.

true, false

data[].card.reissue_pan_from_card_token

Reissues the specified card (known as the "source" card).

This field reissues a card by copying the PAN and PIN from the specified source card to the newly created card. The reissued card has the same PAN and PIN as the source card, but a new expiration date and CVV2 number.

NOTE: By default, the source card is automatically terminated. However, if your program is configured for multiple active cards, you can prevent the source card from being automatically terminated by setting the activation_actions.terminate_reissued_source_card field to false.

Existing card token

data[].card.state

State of the card.

ACTIVE, SUSPENDED, TERMINATED, UNSUPPORTED, UNACTIVATED, LIMITED

data[].card.state_reason

Reason for the state of the card.

255 char max

data[].card.token

Unique identifier of the card.

Existing card token

data[].card.translate_pin_from_card_token

Token of the source card from which to transfer the PIN.

Returned if the card is a reissue or replacement that keeps the source card’s PIN.

Existing card token

data[].card.user_token

Unique identifier of the cardholder.

Existing user token

data[].card_acceptor

Contains information about the merchant.

Existing card_acceptor object

data[].card_acceptor.address

Card acceptor’s address. May be returned if the request uses Transaction Model V1 of the Marqeta Core API. Not returned for V2 requests.

255 char max

data[].card_acceptor.city

Card acceptor’s city.

40 char max

data[].card_acceptor.country_code

Card acceptor’s country code. May be returned if the request uses Transaction Model V2 of the Marqeta Core API. Not returned for V1 requests.

Valid alpha-3 ISO 3166 country code

data[].card_acceptor.mcc

Merchant category code (MCC).

Existing MCC

data[].card_acceptor.mcc_groups

An array of mcc_groups.

One or more mcc_groups

data[].card_acceptor.mid

The merchant identifier.

255 char max

data[].card_acceptor.name

Card acceptor’s name.

50 char max

data[].card_acceptor.network_mid

The merchant identifier on the card network.

255 char max

data[].card_acceptor.postal_code

Card acceptor’s postal code.

255 char max

data[].card_acceptor.state

Two-character state, province, or territorial abbreviation.

For a complete list of valid state and province abbreviations, see Valid state, provincial, and territorial abbreviations.

Note: Non-US merchants may return more than 2 char for this field.

2 char max

data[].card_holder_model

Contains information about a cardholder.

Existing user object

data[].card_holder_model.account_holder_group_token

Associates the specified account holder group with the cardholder.

36 char max

data[].card_holder_model.active

Specifies if the cardholder is in the ACTIVE state on the Marqeta platform.

true, false

data[].card_holder_model.address1

Cardholder’s address.

255 char max

data[].card_holder_model.address2

Additional address information for the cardholder.

255 char max

data[].card_holder_model.authentication

Contains the cardholder’s email address and password information.

Valid authentication object

data[].card_holder_model.authentication.email_verified

Specifies whether the email address has been verified.

true, false

data[].card_holder_model.authentication.email_verified_time

The date and time when the email address was verified.

Format: yyyy-MM-ddTHH:mm:ssZ

data[].card_holder_model.authentication.last_password_update_channel

Specifies the channel through which the password was last changed.

USER_CHANGE, USER_RESET

data[].card_holder_model.authentication.last_password_update_time

The date and time when the password was last changed.

Format: yyyy-MM-ddTHH:mm:ssZ

data[].card_holder_model.birth_date

Cardholder’s date of birth.

Format: yyyy-MM-dd

data[].card_holder_model.business_token

The unique identifier of the business resource.

Existing business token

data[].card_holder_model.city

City where the cardholder resides.

40 char max

data[].card_holder_model.company

Company name.

255 char max

data[].card_holder_model.corporate_card_holder

Specifies if the cardholder holds a corporate card.

true, false

data[].card_holder_model.country

Country where the cardholder resides.

40 char max

data[].card_holder_model.created_time

The date and time when the resource was created, in UTC.

Format: yyyy-MM-ddThh:mm:ssZ

data[].card_holder_model.email

Valid email address of the cardholder.

1–255 chars

data[].card_holder_model.first_name

Cardholder’s first name.

40 char max

data[].card_holder_model.gender

Cardholder’s gender.

F, M

data[].card_holder_model.honorific

Cardholder’s title or prefix: Ms., Mr., Miss, Mrs., and so on.

10 char max

data[].card_holder_model.id_card_expiration_date

The expiration date of the cardholder’s identification card.

Format: yyyy-MM-dd

data[].card_holder_model.id_card_number

The cardholder’s identification card number.

255 char max

data[].card_holder_model.identifications

One or more objects containing identifications associated with the cardholder.

Valid identifications array

data[].card_holder_model.identifications[].expiration_date

The expiration date for the form of identification, if applicable.

Format: yyyy-MM-dd

data[].card_holder_model.identifications[].type

The form of identification.

SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE

data[].card_holder_model.identifications[].value

The identification number associated with the form of identification.

255 char max

data[].card_holder_model.ip_address

Cardholder’s IP address.

39 char max

data[].card_holder_model.last_modified_time

The date and time when the resource was last updated, in UTC.

Format: yyyy-MM-ddThh:mm:ssZ

data[].card_holder_model.last_name

Cardholder’s last name.

40 char max

data[].card_holder_model.metadata

Associates any additional metadata you provide with the cardholder.

You can define the names and values of up to 20 fields in the format "my_name_1": "my_value_1".

data[].card_holder_model.middle_name

Cardholder’s middle name.

40 char max

data[].card_holder_model.nationality

Cardholder’s nationality.

255 char max

data[].card_holder_model.notes

Any additional information pertaining to the cardholder.

255 char max

data[].card_holder_model.parent_token

The unique identifier of a user or business already in the system.

1–36 chars

data[].card_holder_model.passport_expiration_date

The expiration date of the cardholder’s passport.

Format: yyyy-MM-dd

data[].card_holder_model.passport_number

Cardholder’s passport number.

40 char max

data[].card_holder_model.password

Cardholder’s user account password on the Marqeta platform.

1–255 chars

data[].card_holder_model.phone

Cardholder’s telephone number.

255 char max

data[].card_holder_model.postal_code

Postal code of the cardholder’s address.

10 char max

data[].card_holder_model.ssn

The cardholder’s Social Security Number.

Nine digits only, no delimiters.

data[].card_holder_model.state

State in which the cardholder resides.

2 char max

data[].card_holder_model.status

Specifies the status of the cardholder on the Marqeta platform.

UNVERIFIED, LIMITED, ACTIVE, SUSPENDED, CLOSED

data[].card_holder_model.token

The unique identifier of the cardholder.

1–36 chars

data[].card_holder_model.uses_parent_account

Indicates whether the child shares balances with the parent (true), or the child’s balances are independent of the parent (false).

true, false

data[].card_holder_model.zip

ZIP code of the cardholder’s address.

10 char max

data[].card_security_code_verification

Contains information about a verification check performed on the card’s security code.

Existing card_security_code_verification object

data[].card_security_code_verification.response

Contains information about the response, including the response code and response memo.

Existing response object

data[].card_security_code_verification.response.additional_information

Information about the relevant velocity control for the transaction, if applicable.

The additional_information field returns a string in the following format: <Velocity control name>, cumulative transaction amount is <X>, where X is the cumulative transaction amount value calculated by Marqeta. For example: 500 max spend per day, cumulative transaction amount is 750.

data[].card_security_code_verification.response.code

Four-digit code corresponding to the outcome of the attempted transaction.

card_security_code_verification.response.code indicates whether the verification check passed. It can have these possible values:

Four digits

data[].card_security_code_verification.response.memo

Information on the outcome of the attempted transaction.

255 char max

data[].card_security_code_verification.type

Indicates the type of security code. Can have these possible values:

CVV1, CVV2, ICVV, DCVV

data[].card_token

Unique identifier of the card. Useful when a single account holder has multiple cards.

36 char max

data[].cardholder_authentication_data

Contains 3-D Secure verification data:

Existing cardholder_authentication_data object

data[].cardholder_authentication_data.acquirer_exemption

Indicates 3D Secure authentication exemptions from the acquirer. This array is returned if it is included in the transaction data from the card network.

MERCHANT_INITIATED_TRANSACTION, TRANSACTION_RISK_ANALYSIS, RECURRING_PAYMENT, LOW_VALUE_PAYMENT, SCA_PERFORMED, SECURE_CORPORATE_PAYMENT, AUTHENTICATION_OUTAGE_EXCEPTION

data[].cardholder_authentication_data.authentication_method

Specifies the 3D Secure authentication method.

null, BIOMETRIC_FACE, BIOMETRIC_FINGERPRINT, VOICE_RECOGNITION, IN_APP_LOGIN, AUDIO_CALL, VIDEO_CALL, OTP_SMS, OTP_EMAIL, KNOWLEDGE_BASED, OTHER

data[].cardholder_authentication_data.authentication_status

Specifies the status of the 3D Secure authentication.

SUCCESS, FAILED, CANCELLED, NOT_AUTHENTICATED

data[].cardholder_authentication_data.electronic_commerce_indicator

The status of the verification attempt, as provided by a transaction participant.

authentication_successful, authentication_attempted, no_authentication

data[].cardholder_authentication_data.three_ds_message_version

Specifies the 3D Secure message version used for authentication.

1.0.2, 2.1.0, 2.2.0

data[].cardholder_authentication_data.verification_result

The result of the verification attempt, as provided by a transaction participant.

data[].cardholder_authentication_data.verification_value_created_by

Transaction participant who determined the verification result.

issuer_acs, issuer_attempts_server, network, network_attempts_server

data[].cash_back_amount

Amount of cash back requested by the cardholder during the transaction. Included in the total transaction amount.

Format: 0.00

data[].chargeback

Contains the chargeback object associated with this transaction if a chargeback has been initiated.

Existing chargeback object

data[].chargeback.amount

Amount of the chargeback.

0.01 min

data[].chargeback.channel

Channel the chargeback came through.

GATEWAY, GATEWAY_AUTOMATED, ISSUER, ISSUER_AUTOMATED

data[].chargeback.created_time

Date and time when the chargeback was created. Not returned for transactions when the associated chargeback is in the INITIATED state.

Format: yyyy-MM-ddThh:mm:ssZ

data[].chargeback.credit_user

Whether to credit the user for the chargeback amount.

true, false

data[].chargeback.last_modified_time

Date and time when the chargeback was last modified. Not returned for transactions when the associated chargeback is in the INITIATED state.

Format: yyyy-MM-ddThh:mm:ssZ

data[].chargeback.memo

Additional comments about the chargeback.

1–1024 chars

data[].chargeback.network

Network handling the chargeback.

MARQETA, DISCOVER, MASTERCARD, PULSE, VISA

data[].chargeback.network_case_id

Network-assigned identifier of the chargeback.

50 char max

data[].chargeback.reason_code

Identifies the standardized reason for the chargeback.

See The reason_code field in the Cases (Visa) API reference.

data[].chargeback.state

State of the case.

INITIATED, REPRESENTMENT, PREARBITRATION, ARBITRATION, CASE_WON, CASE_LOST, NETWORK_REJECTED, WITHDRAWN

data[].chargeback.token

Unique identifier of the chargeback.

1–36 chars

data[].chargeback.transaction_token

Unique identifier of the transaction being charged back.

1–36 chars

data[].clearing_record_sequence_number

A sequence number that identifies a specific clearing message among multiple clearing messages for an authorization.

Sequence number returned in the clearing record

data[].created_time

Date and time when the Marqeta platform created the transaction entry, in UTC format. For example, when Marqeta processed the clearing record for a refund.

Format: yyyy-MM-ddThh:mm:ssZ

data[].currency_code

Currency type of the transaction.

Valid three-digit ISO 4217 currency code

data[].currency_conversion

Contains information about currency conversion.

Existing currency_conversion object

data[].currency_conversion.network

Contains information from the card network about currency conversion, including the original currency of the transaction, the amount of the transaction in the original currency, and the conversion rate.

Existing network object

data[].currency_conversion.network.conversion_rate

Conversion rate between the origination currency and the settlement currency.

Returned when the transaction currency is different from the origination currency.

Current conversion rate.

NOTE: A value of 0 or 1 indicates no conversion; the currencies are the same.

data[].currency_conversion.network.dynamic_currency_conversion

Indicates whether currency conversion was performed dynamically at the point of sale.

true, false

data[].currency_conversion.network.original_amount

Amount of the transaction in the currency in which it originated.

Decimal amount.

data[].currency_conversion.network.original_currency_code

Currency type of the origination currency.

Valid three-digit ISO 4217 currency code

data[].currency_conversion.network.settlement_data

Contains information from the card network about currency conversion at the time of settlement, including the original currency of the transaction, the amount of the transaction in the original currency, and the conversion rate.

Existing settlement_data object

data[].currency_conversion.network.settlement_data.amount

The settled amount.

Format: 0.00

data[].currency_conversion.network.settlement_data.conversion_rate

Returned when the transaction currency is different from the origination currency.

Conversion rate between the origination currency and the settlement currency.

Current conversion rate.

NOTE: A value of 0 or 1 indicates no conversion; the currencies are the same.

data[].currency_conversion.network.settlement_data.currency_code

The ISO 4217 code of the currency used in the transaction.

Valid three-digit ISO 4217 currency code

data[].digital_wallet_token

Contains information about the digital wallet that funded the transaction.

Returned for all transactions funded by a digital wallet or related to digital wallet token provisioning.

For more on digital wallets, see the Digital Wallets Management API reference and Digital Wallets and Tokenization developer guide.

Existing digital_wallet_token object

data[].digital_wallet_token.address_verification

Contains address verification information.

Existing address_verification object

data[].digital_wallet_token.address_verification.name

The name of the cardholder.

40 char max

data[].digital_wallet_token.address_verification.postal_code

Postal code.

10 char max

data[].digital_wallet_token.address_verification.street_address

Street address provided by the cardholder.

40 char max

data[].digital_wallet_token.address_verification.zip

ZIP code.

10 char max

data[].digital_wallet_token.card_token

Unique identifier of the card.

Existing card token

data[].digital_wallet_token.created_time

Date and time when the digital wallet token object was created.

Format: yyyy-MM-ddThh:mm:ssZ

data[].digital_wallet_token.device

Contains information related to the device being provisioned.

Existing device object

data[].digital_wallet_token.device.device_id

Identity number of the device.

20 char max

data[].digital_wallet_token.device.ip_address

Device’s IP address.

IP address format, 50 char max

data[].digital_wallet_token.device.language_code

Language the device is configured to use.

50 char max

data[].digital_wallet_token.device.location

Geographic coordinates of the device.

Latitude and longitude in DDD.DD/DDD.DD format.

NOTE: Both the longitude and latitude are prefixed with either a + or - symbol, for example: +42.29/-71.07.

That also allows us to finish the sentence with a full stop without confusing the reader.

data[].digital_wallet_token.device.name

Name of the device.

50 char max

data[].digital_wallet_token.device.phone_number

Device’s telephone number.

50 char max

data[].digital_wallet_token.device.token

Unique identifier of the device object.

36 char max

data[].digital_wallet_token.device.type

Type of device being provisioned.

MOBILE_PHONE, WATCH, TABLET, MOBILE_PHONE_OR_TABLET, VEHICLE, APPLIANCE, LAPTOP, GAMING_DEVICE, UNKNOWN

data[].digital_wallet_token.fulfillment_status

Digital wallet token’s provisioning status.

For fulfillment status descriptions, see Create Digital Wallet Token Transition.

DECISION_RED, DECISION_YELLOW, DECISION_GREEN, REJECTED, PROVISIONED

data[].digital_wallet_token.issuer_eligibility_decision

The Marqeta platform’s decision as to whether the digital wallet token should be provisioned.

For all other values, check the value of the fulfillment_status field to definitively ascertain the provisioning outcome.

NOTE: The value invalid.cid indicates an invalid CVV2 number.

0000, cardaccount.verified, card.suspicious, token.activation.verification.required, token.activation-request.decline, card.not.active, invalid.cid, card.expired, card.suspended, cardholder.not.active

data[].digital_wallet_token.last_modified_time

Date and time when the digital wallet token object was last modified.

Format: yyyy-MM-ddThh:mm:ssZ

data[].digital_wallet_token.metadata

Contains additional information about the digital wallet token.

Existing digital_wallet_token_metadata object

data[].digital_wallet_token.metadata.cardproduct_preferred_notification_language

The language specified in the config.transaction_controls.notification_language field of the card product: ces (Czech), deu (German), eng (English), fra (French), ita (Italian), pol (Polish), spa (Spanish), swe (Swedish)

The ISO maintains the full list of ISO 3166 two- and three-digit numeric country codes.

ces, deu, eng, fra, ita, pol, spa, swe

data[].digital_wallet_token.metadata.issuer_product_config_id

The unique identifier of the product configuration on the Marqeta platform.

255 char max

data[].digital_wallet_token.state

State of the digital wallet token.

For state descriptions, see Transitioning Token States.

REQUESTED, REQUEST_DECLINED, ACTIVE, SUSPENDED, TERMINATED

data[].digital_wallet_token.state_reason

Reason why the digital wallet token transitioned to its current state.

255 char max

data[].digital_wallet_token.token

Unique identifier of the digital wallet token.

Existing digital wallet token.

data[].digital_wallet_token.token_service_provider

Contains information held and provided by the token service provider (card network).

Existing token_service_provider object

data[].digital_wallet_token.token_service_provider.correlation_id

The unique value representing a tokenization request (Mastercard only).

Existing correlation identifier

data[].digital_wallet_token.token_service_provider.pan_reference_id

Unique identifier of the digital wallet token PAN within the card network.

Existing PAN Reference ID

data[].digital_wallet_token.token_service_provider.token_assurance_level

(Mastercard only) Represents the confidence level in the digital wallet token.

0-99

data[].digital_wallet_token.token_service_provider.token_eligibility_decision

Digital wallet’s decision as to whether the digital wallet token should be provisioned.

DECISION_RED, DECISION_YELLOW, DECISION_GREEN

data[].digital_wallet_token.token_service_provider.token_expiration

Expiration date of the digital wallet token.

Format: MMyy

data[].digital_wallet_token.token_service_provider.token_pan

Primary account number (PAN) of the digital wallet token.

16 char max

data[].digital_wallet_token.token_service_provider.token_reference_id

Unique identifier of the digital wallet token within the card network.

Existing Token Reference ID

data[].digital_wallet_token.token_service_provider.token_requestor_id

Unique numerical identifier of the token requestor within the card network. These ID numbers map to token_requestor_name field values as follows:

Mastercard

Visa

data[].digital_wallet_token.token_service_provider.token_requestor_name

Name of the token requestor within the card network.

data[].digital_wallet_token.token_service_provider.token_score

Token score assigned by the digital wallet.

25 char max

data[].digital_wallet_token.token_service_provider.token_type

Type of the digital wallet token.

MERCHANT_CARD_ON_FILE, DEVICE_SECURE_ELEMENT, DEVICE_CLOUD_BASED, ECOMMERCE_DIGITAL_WALLET

data[].digital_wallet_token.user

Contains information about a cardholder.

Existing user object

data[].digital_wallet_token.user.account_holder_group_token

Associates the specified account holder group with the cardholder.

36 char max

data[].digital_wallet_token.user.active

Specifies if the cardholder is in the ACTIVE state on the Marqeta platform.

true, false

data[].digital_wallet_token.user.address1

Cardholder’s address.

255 char max

data[].digital_wallet_token.user.address2

Additional address information for the cardholder.

255 char max

data[].digital_wallet_token.user.authentication

Contains the cardholder’s email address and password information.

Valid authentication object

data[].digital_wallet_token.user.authentication.email_verified

Specifies whether the email address has been verified.

true, false

data[].digital_wallet_token.user.authentication.email_verified_time

The date and time when the email address was verified.

Format: yyyy-MM-ddTHH:mm:ssZ

data[].digital_wallet_token.user.authentication.last_password_update_channel

Specifies the channel through which the password was last changed.

USER_CHANGE, USER_RESET

data[].digital_wallet_token.user.authentication.last_password_update_time

The date and time when the password was last changed.

Format: yyyy-MM-ddTHH:mm:ssZ

data[].digital_wallet_token.user.birth_date

Cardholder’s date of birth.

Format: yyyy-MM-dd

data[].digital_wallet_token.user.business_token

The unique identifier of the business resource.

Existing business token

data[].digital_wallet_token.user.city

City where the cardholder resides.

40 char max

data[].digital_wallet_token.user.company

Company name.

255 char max

data[].digital_wallet_token.user.corporate_card_holder

Specifies if the cardholder holds a corporate card.

true, false

data[].digital_wallet_token.user.country

Country where the cardholder resides.

40 char max

data[].digital_wallet_token.user.created_time

The date and time when the resource was created, in UTC.

Format: yyyy-MM-ddThh:mm:ssZ

data[].digital_wallet_token.user.email

Valid email address of the cardholder.

1–255 chars

data[].digital_wallet_token.user.first_name

Cardholder’s first name.

40 char max

data[].digital_wallet_token.user.gender

Cardholder’s gender.

F, M

data[].digital_wallet_token.user.honorific

Cardholder’s title or prefix: Ms., Mr., Miss, Mrs., and so on.

10 char max

data[].digital_wallet_token.user.id_card_expiration_date

The expiration date of the cardholder’s identification card.

Format: yyyy-MM-dd

data[].digital_wallet_token.user.id_card_number

The cardholder’s identification card number.

255 char max

data[].digital_wallet_token.user.identifications

One or more objects containing identifications associated with the cardholder.

Valid identifications array

data[].digital_wallet_token.user.identifications[].expiration_date

The expiration date for the form of identification, if applicable.

Format: yyyy-MM-dd

data[].digital_wallet_token.user.identifications[].type

The form of identification.

SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE

data[].digital_wallet_token.user.identifications[].value

The identification number associated with the form of identification.

255 char max

data[].digital_wallet_token.user.ip_address

Cardholder’s IP address.

39 char max

data[].digital_wallet_token.user.last_modified_time

The date and time when the resource was last updated, in UTC.

Format: yyyy-MM-ddThh:mm:ssZ

data[].digital_wallet_token.user.last_name

Cardholder’s last name.

40 char max

data[].digital_wallet_token.user.metadata

Associates any additional metadata you provide with the cardholder.

You can define the names and values of up to 20 fields in the format "my_name_1": "my_value_1".

data[].digital_wallet_token.user.middle_name

Cardholder’s middle name.

40 char max

data[].digital_wallet_token.user.nationality

Cardholder’s nationality.

255 char max

data[].digital_wallet_token.user.notes

Any additional information pertaining to the cardholder.

255 char max

data[].digital_wallet_token.user.parent_token

The unique identifier of a user or business already in the system.

1–36 chars

data[].digital_wallet_token.user.passport_expiration_date

The expiration date of the cardholder’s passport.

Format: yyyy-MM-dd

data[].digital_wallet_token.user.passport_number

Cardholder’s passport number.

40 char max

data[].digital_wallet_token.user.password

Cardholder’s user account password on the Marqeta platform.

1–255 chars

data[].digital_wallet_token.user.phone

Cardholder’s telephone number.

255 char max

data[].digital_wallet_token.user.postal_code

Postal code of the cardholder’s address.

10 char max

data[].digital_wallet_token.user.ssn

The cardholder’s Social Security Number.

Nine digits only, no delimiters.

data[].digital_wallet_token.user.state

State in which the cardholder resides.

2 char max

data[].digital_wallet_token.user.status

Specifies the status of the cardholder on the Marqeta platform.

UNVERIFIED, LIMITED, ACTIVE, SUSPENDED, CLOSED

data[].digital_wallet_token.user.token

The unique identifier of the cardholder.

1–36 chars

data[].digital_wallet_token.user.uses_parent_account

Indicates whether the child shares balances with the parent (true), or the child’s balances are independent of the parent (false).

true, false

data[].digital_wallet_token.user.zip

ZIP code of the cardholder’s address.

10 char max

data[].digital_wallet_token.wallet_provider_profile

Contains information held and provided by the digital wallet provider.

Existing wallet_provider_profile object

data[].digital_wallet_token.wallet_provider_profile.account