/
30 minute read
September 8, 2022

Managing Customers in the Dashboard

Use Customers in the Marqeta Dashboard to manage your users and businesses by viewing, creating, and editing user and business information.

Using Customers, you can view all of the customers and businesses in your program, and:

  • Manage user and business information.

  • Create cards from your card products.

  • Manage cards, transactions, history, notes, and transitions for users.

  • Manage card details, card transactions, history, and card transitions for cards.

  • Manage business details, children users, transactions, history, notes, and transitions for businesses.

  • Terminate, lock, or replace customer cards.

  • Initiate disputes.

The basics

To manage users and businesses, log into the Marqeta Dashboard and select Customers > Users or Customers > Businesses from the sidebar. For more on how to access the Marqeta Dashboard, see Accessing the Marqeta Dashboard.

Users

Is this helpful?

Yes
No

Users

In Users you can manage users and cards, including:

  • View users and user information.

  • Modify user status.

  • Create cards from card products.

  • View cardholders' card information.

  • Manage cards by terminating, locking, or replacing cards.

  • View user or card transactions, history, notes, and transitions.

  • Initiate disputes.

Viewing a list of users

To view a list of users and a summary of user information, select Customers > Users in the sidebar.

Users

Is this helpful?

Yes
No

The displayed list includes default columns. To modify the displayed columns, see Setting the columns to display and column order.

Searching for a user

To find a specific user:

  • In the sidebar, select Customers > Users.

  • Select Filter table.

    Find a user

    Is this helpful?

    Yes
    No
  • Enter the values you want to use for the filter. You can search by first name, last name, phone, email, full SSN or last four digits, full card PAN or last four digits, or the account holder’s UAI.

  • Select Filter.

Setting the columns to display and column order

To customize the column display:

  • In the sidebar, select Customers > Users.

  • Select the gear icon in the upper-right corner of the list, and select Modify columns.

  • In Customize table columns, select the columns you want to display.

  • To change the display order, select and hold the row and move it to the new position.

  • Select Save.

  • To reset the column display, select the Reset table to default option from the gear icon.

Managing user information

To view and manage cardholder information:

  • In the sidebar, select Customers > Users and select the user.

  • Use the tabs to view and edit user information.

The following tabs are available:

Tab Description

User details

User information, such as name, address, status, and forms of information used to validate the user.

Cards

The cards associated with this user.

Accounts

The accounts associated with this user.

Transactions

Transactions for this user.

History

Displays a history of changes to the user information.

Notes

Displays any notes associated with the user.

Transitions

Displays a list of transitions for the user.

User details

Use the User details tab to view information, including user information, identifications, and velocity and authorization controls.

User details are displayed in the User Details tab, which includes User Info, Identifications, and Velocity Controls & Auth Controls tabs.

User details

Is this helpful?

Yes
No

User info

Field Description

Active

Indicates whether the user is active (Active, Limited) or inactive (Unverified, Suspended, Closed).

Status

The user’s status, which determines the user’s capabilities. To change the status, select Change.

Token

The user’s unique token.

First name

The user’s first name. Required for KYC verification checks.

Middle name

The user’s middle name.

Last name

The user’s last name. Required for KYC verification checks.

Email

A unique and valid email address for the user.

Phone

The telephone number of the primary contact.

Address

The user’s address.

Honorific

The user’s title, such as Mr., Ms, or Mrs.

Uses parent account

If this is a child account, indicates whether the child account shares a balance with the parent account (true) or maintains an independent balance (false).

Corporate card holder

Indicates whether the user also has a corporate card: true if yes, false if not.

Company

The user’s company.

Nationality

The user’s nationality.

IP address

The user’s IP address.

API note

A note applied on the business object.

Parent token

The parent token for the user, if any.

Business token

The business token related to the user, if any.

Account holder group token

A token that associates the user with a group.

Created

The date and time when the user was created.

Last modified

The date and time when the user’s information was last updated.

Metadata

Metadata key/value pair, if any. To define metadata, select Add New.

Identifications

Identifications define the forms of identification used to validate a user. This information is required for KYC checks. To add an identification, select Edit. To reveal an SSN, select Reveal; to conceal the number, select Hide.

Field Description

SSN

The user’s social security number.

Passport number

The user’s passport number.

Passport expiration date

The date when the user’s passport expires.

ID card number

The user’s ID card number.

ID card number expiration

The date when the user’s ID card expires.

Velocity controls & auth controls

A velocity control is a type of control that limits user spending, such as how much a user can spend or the number of transactions they can make within a given time interval.

An authorization control is a type of spend control that limits where users can transact. You can configure authorization controls to limit spending at a single merchant or a group of merchants. Authorization controls can apply to a single user, all users associated with a particular card product, or all users in your program.

Velocity controls
Field Description

Active

Indicates whether the velocity control is active: true, if active; false if inactive.

Token

The unique identifier for the velocity control.

Name

The name of the velocity control.

Amount limit

The maximum amount of money that can be spent within the time period defined in the velocity_window field.

Usage limit

The maximum number of times the card can be used within the time period defined in the velocity_window field.

Velocity window

The time period to which the amount limit and usage limit values apply: DAY, WEEK, MONTH, LIFETIME, TRANSACTION.

Approvals only

Indicates whether only approved are subject to control.

Include purchases

Indicates whether purchases are included.

Include withdrawals

Indicates whether withdrawals are included.

Include transfers

Indicates whether transfers are included.

Include cashback

Indicates whether cashback is included.

Currency code

The currency code.

Authorization controls

An authorization control is a type of spend control that limits where users can transact.

Merchant scope

Merchant scope defines the group of merchants to which the authorization control applies.

Field Description

Merchant ID

The unique identification number of a merchant.

Merchant Category Code

A single MCC (Merchant Category Code). Identifies the type of goods or services provided by the merchant.

Merchant Category Code Group

Token identifying a group of MCCs.

Association

The association values indicate the card product token or user token associated with the authorization control.

Field Description

Card product token

A card product token to apply the authorization control to all users holding active cards associated with the card product.

User token

A user token to apply the authorization control to a single user.

Account balance

The account balance values show current balances for the user, including the available balance, pending credits, and ledger balance.

Field Description

Available balance

The available balance shows the ledger balance minus any authorized transactions that have not yet cleared. This is the cardholder’s purchasing power. If you are using JIT Funding, this balance is usually 0.00.

Credit balance

Not currently in use.

Pending credits

Pending credits shows the ACH loads that have been accepted, but for which the funding time has not yet elapsed.

Ledger balance

When using standard funding, the ledge balance shows the funds that are available to spend immediately, including any authorized transactions that have not yet cleared. When using Just-in-Time (JIT) Funding, this shows the authorized funds that are currently on hold, but have not yet cleared.

Editing user info

To edit a user’s information:

  • In the sidebar, select Customers > Users, and then select the user.

  • Select the Edit button (pencil icon) in the upper-right corner of the information pane and enter values for any of the fields.

  • Select Save.

Changing user status

A user’s status can be Active, Limited, Unverified, Suspended, or Closed. Both Active and Limited indicate an Active status.

To change a user’s status:

  • In the sidebar, select Customers > Users, and then select the user. To search for a user, select Filter.

  • Select the Change button to the right of the Status value.

  • Choose a new status, choose a reason, and enter a note.

  • Select Save.

Warning
If a user’s account is Inactive, their cards will not authorize transactions, even if the cards themselves are Active. If the user is a secondary user, there will also be a Parent Account link pointing back to the primary user.

Cards

The Cards tab lists all cards that are associated with the user account, and all of its child accounts. Each line item shows the last four digits of the card number, the name on the card, and the payment instrument type (physical stripe, chip, or virtual).

Cards

Is this helpful?

Yes
No

The following tabs are available:

Tab Description

Card details

User information, such as name, address, status, and forms of information used to validate the user.

Card transactions

Transactions for this user.

History

Displays a history of changes to the user information.

Card transitions

Displays a list of transitions for the user.

Digital wallet tokens

Displays a list of digital wallet tokens for the user, if any.

Creating a card

You can create a new card for a user by selecting a current card product. When you create a card, you can set card controls involving MCCs on the allow list, usage types, velocity controls, and amount limits.

To create a card:

  • In the sidebar, select Customers > Users, and then select the user.

  • Select Manual Create Card from the Actions dropdown button at the top right.

  • Select a card product from the list.

  • In Manual create card, specify any optional controls for the card. For details, see Manually creating a card.

  • Select Create card.

Viewing card details

To view card details:

  • In the sidebar, select Customers > Users, and then select the user.

  • Select the user from the list.

  • Select the Cards tab.

    Card details

    Is this helpful?

    Yes
    No

Card information

View detailed card information, including the state of the card. You can also expand to view all details and change the card status here.

Field Description

Start date

The start date for the card.

Instrument

The type of card: Physical or Virtual.

Has PIN

Indicates whether the card has a PIN.

Created

The date and time when the card was created.

Last modified

The date and time when the card was last modified.

Card token

The card’s unique identifier.

Card shipping
Field Description

Method

The shipping company and shipping service level, such as USPS_REGULAR or FEDEX_EXPEDITED.

Processing time

The time required to process the card.

Card fulfillment status

Status of the card related to order and delivery: ISSUED, ORDERED, REJECTED, SHIPPED, DIGITALLY_PRESENTED.

Name line 1

The first line of personalized text printed on the face of the card.

Name line 2

The second line of personalized text printed on the face of the card.

Care of line

Adds the specified value as a C/O (care of) line to the mailing carrier.

Recipient address

Address to which the card will be shipped.

Return address

Address to which card will be returned if shipping fails.

Card velocity and auth controls
Field Description

MCC auth control

Indicates the auth control for the card.

Usage type

Indicates the usage type for the card: multi use or single use.

Card transactions

The Transactions tab shows all of the transactions for a specific card.

To view transactions for a specific card:

  • From the sidebar, select Customers > Users, then select the user. To search for a user, select Filter table.

  • Select the Cards tab and select the card.

  • Select the Card transactions tab to view information on transactions for specific cards. Use the Filter table options to search for a specific transaction. For details on transaction fields for cards, see Transactions for users.

You can view all of the transactions for a user by going to Customers > Users and selecting the Transactions tab.

Initiating a dispute

Transactions can be disputed if they are in either a cleared or completion state.

To initiate a dispute:

  • From the sidebar, select Customers > Users, then select the user. To search for a user, select Filter.

  • Select the Cards tab and find the card that was used to complete the transaction.

  • Select the row of the card from the list of cards.

  • Select the Transactions tab. To search for the transaction, select Filter.

  • Select vertical ellipsis at the far right of the row and select Dispute.

Card history

Use History to view the audit log associated with a card.

To view a card’s history:

  • From the sidebar, select Customers > Users, then select the user. To search for a user, select Filter table.

  • Select the Cards tab and select the card.

  • Select the History tab. Use the Filter table options to search for a specific record.

Card transitions

Use the Transitions tab to view all transitions associated with a card.

To view a card transition:

  • From the sidebar, select Customers > Users, then select the user. To search for a user, select Filter table.

  • Select the Cards tab and select the card.

  • Select the Card transitions tab. Use the Filter table options to search for a specific record.

    Field Description

    Date

    The date and time when the transition occurred.

    Status

    The current status of the card.

    Reason

    The reason that the card status changed.

    Note

    An explanation of why the card status changed.

Digital wallet tokens

Use the Digital Wallet Tokens tab to view details of and manage transitions for all the digital wallet tokens associated with a user. The Digital Wallet Tokens tab displays the last four digits of the PAN with which the tokens are associated.

About digital wallet token transitions

As with other objects on the Marqeta platform, such as users and cards, digital wallet tokens can be independently transitioned between states.

The two most common use cases for transitioning a digital wallet token are token activation (such as yellow flow activation) and token termination (if a user has reported to you that their device or account was lost or stolen, for example).

Token activation is primarily handled automatically, but the ability to manually activate a token is a requirement of both Visa and Mastercard. You can meet this requirement through your own service applications using Marqeta’s APIs, or through the Marqeta Dashboard. Tokens can be activated through automatic mechanisms and can be terminated by the user directly on their phone or by "find my device" features. You will be notified through webhooks of these changes.

Warning
Wallet tokens will remain active unless explicitly terminated, even if the underlying card state is changed.
Field Description

Status

The current state of the digital wallet token: active, requested, suspended, or terminated.

Token PAN

The last four digits of the digital wallet token PAN. This is the number that will typically appear on a user’s receipt.

Token reference ID

The digital wallet token reference identifier. This field is used for troubleshooting and is not used for payments.

PAN reference ID

The PAN reference identifier. This field is used for troubleshooting and is not used for payments.

Wallet name

The name of the wallet with which the digital wallet token is associated. For example, Apple Pay.

Device

The device with which the digital wallet token is associated. For example, Mobile Phone.

Last modified

The date and time when the digital wallet token was last modified.

Quick actions

Select the vertical ellipses in the rightmost field to access the quick actions menu.

  • View details: Select View details to view the digital wallet token details. See Digital wallet token details

  • Lock: Select Lock to suspend the digital wallet token. The token moves to the suspended state, and the token details are displayed. You can lock a token when it is in the active state.

  • Terminate: Select Terminate to permanently disable the digital wallet token. The token moves to the terminated state.

  • Activate: Select Activate to enable the digital wallet token that is currently in a pending status. The token moves to the active state, and the token details appear.

Digital wallet token details

To view details and transitions for a digital wallet token:

  • Select the row for the token, or select View Details from the quick actions menu for that token.

  • In Details, you can see additional details about the request and the device, including why a token request might have been declined. You can also lock, terminate, or activate a digital wallet token on the Token details tab in lieu of the quick actions. The token details tab displays information about the digital wallet token in two sections: Token summary and Token details. The Token summary section provides the following information:

Field Description

Device

The device with which the digital wallet token is associated. For example, Mobile Phone.

Device ID

The unique device identifier as defined by the digital wallet, if applicable. For Apple Pay, this is the SEID. It appears for Apple Pay, Google Wallet, and Samsung Wallet, but it does not appear for e-commerce/card on file tokenization.

Phone number

The phone number associated with the device being tokenized. This may be the full number or only last four digits. This is not provided for e-commerce tokenization or if there is no phone number associated with the device (a mobile phone with no SIM installed for example).

Wallet name

The name of the wallet with which the digital wallet token is associated. For example, Apple Pay.

Token PAN

The last four digits of the digital wallet token PAN, which the user will frequently see on receipts and is visible within the digital wallet.

Token expiration

The expiration date of the digital wallet token.

Wallet provider risk score

The digital wallet provider’s decision as to whether the digital wallet token should be provisioned: red, yellow, green.

Wallet provider PAN source

The source of the PAN used by the digital wallet provider, such as a mobile banking application.

Wallet provider reason score

The reason for the digital wallet provider’s provisioning decision.

The Token details section provides the following information:

Field Description

Token reference ID

The digital wallet token reference identifier. For Mastercard, this field is blank until the tokenization process is completed. It is not available while the status is requested.

PAN reference ID

The PAN reference identifier. For Mastercard, this is blank until the tokenization process is completed. It is not available while the status is requested.

Token fulfillment status

The fulfillment state of the digital wallet token: red, yellow, green, provisioned, rejected.

Issuer eligibility decision

The Marqeta platform’s decision as to whether the digital wallet token should be provisioned. 0000 indicates that the token should be provisioned without any further steps.

Time created

The date and time when the digital wallet token was created. Expressed in UTC.

Last modified

The date and time when the digital wallet token was last modified. Expressed in UTC.

Language code

The language code for the digital wallet token. For example, English.

To view transitions for the digital wallet token, select the Token transitions tab. The Token transitions tab displays a historical list of all transitions for the digital wallet token.

Changing card status

You can set a card’s status to Active, Terminated, or Suspended.

To change a card’s status:

  • From the sidebar, select Customers > Users, then select the user. To search for a user, select Filter table.

  • Select the Cards tab.

  • Select the vertical ellipses to the right in the row of the card to report and select Change Status.

  • In the window, select the Change button next to the card state.

  • Select the new state, select a reason for the change from the dropdown list, and add any additional notes.

  • Select Save.

Locking a card

Locking a card temporarily suspends card activity.

To lock a card:

  • From the sidebar, select Customers > Users, then select the user. To search for a user, select Filter table.

  • Select the card in the Cards tab.

  • Select Lock card.

  • To unlock the card, select Unlock card.

Replacing a card

When replacing a damaged or expiring card with the same card number, the current card remains active until the new card is activated, at which point the current card is terminated.

To replace a damaged or expiring card:

  • From the sidebar, select Customers > Users, then select the user. To search for a user, select Filter table.

  • Select the card in the Cards tab.

  • Select Replace card.

  • Send a replacement card to the address under Recipient address in the Replace card window.

  • Select the reason that the card is being replaced.

  • Add any notes for the card transition, if necessary.

  • Select Replace card and reissue.

After a card has been activated, it cannot be returned to Unactivated status.

Reporting a card lost or stolen

Reporting that a card is lost or stolen terminates the card and reissues a new card with a new PAN, which is digitally available (if virtual) or mailed to the user (if physical). The physical card will be sent to the recipient address on file. Terminated cards cannot be used or reactivated.

To report a card lost or stolen:

  • In Customers > Users, select the user. Use the Filter, Columns, or Reset buttons to find the card, if necessary.

  • On the Cards tab, select the card.

  • From the button at the right of the row of the card to report, select Report Card Lost/Stolen.

  • In the pop-up window, select Report Lost/Stolen.

Accounts

Use the Accounts tab to view the accounts associated with a user.

To view a user’s accounts:

  • In the sidebar, select Customers > Users and then select the user.

  • Select the Accounts tab. The Accounts tab provides the following account information.

Field Description

Status

The current account status.

Account Number

The account number.

Routing Number

The account routing number.

Creation Date

The date that the account was created.

Account Token

The account token.

Transactions

Use the Transactions tab to view all transactions associated with a user.

To view the transactions for a user:

  • In the sidebar, select Customers > Users and then select the user.

  • Select the Transactions tab.

    User details

    Is this helpful?

    Yes
    No
  • Select Filter table to search for a transaction or Modify columns to display more columns.

    Field Description

    Token

    Unique identifier of the transaction, formatted as a UUID.

    Amount

    The transaction amount.

    State

    The transaction state: PENDING, CLEARED, COMPLETION, DECLINED, ERROR, ALL

    Digital Wallet

    Indicates if a digital wallet was used for the transaction. If so, a link to the digital wallet token is provided.

    Merchant

    The merchant involved in the transaction.

    Location

    The location of the transaction.

    Date

    Date and time of the transaction.

    Card Acceptor Type

    The card acceptor type, such as the MID, MCC, or MCC group.

    Response Code

    The response code for the transaction. See transaction response codes.

    Response Memo

    A memo related to the transaction response, if any.

    Type

    The transaction type: authorization, gpa.credit.authorization, gpa.credit, authorization.reversal, gpa.credit.authorization.reversal.

    Settlement Date

    Date and time when funds were moved for a transaction (for example, in the case of a refund, when funds were credited to the user).

    Approval Code

    The unique ID assigned to a given authorization. Is printed on the receipt at point of sale.

    Network

    The card network used to complete the transaction (DISCOVER, MASTERCARD, PULSE, VISA, or MARQETA).

    Subnetwork

    The subnetwork used to complete the transaction. Possible values include the following:

    • VISANET – VisaNet signature-based transactions.

    • VISANETDEBIT – VisaNet Debit PIN-based transaction.

    • VISAINTERLINK – Visa Interlink PIN-based transactions.

    • VISAPLUS – ATM withdrawals on Visa.

    • MAESTRO – PIN-based transactions on Mastercard.

    • CIRRUS – ATM withdrawals on Mastercard.

    • MASTERCARDDEBIT – Signature-based transactions on Mastercard.

    • GATEWAY_JIT – Gateway JIT Funding transactions.

    • MANAGED_JIT – Managed JIT Funding transactions or for transactions that occur while Commando Mode is enabled.

    Request Amount

    Used for clearing/settling transactions to compare to the original authorization amount.

    Duration

    Duration of the transaction on Marqeta servers, in milliseconds.

    AVS

    Address Verification System (AVS) data provided by the merchant.

    Verification Result

    The result of the verification.

    Currency Code

    The three-digit ISO 4217 currency type of the transaction.

    POS

    Information about the point of sale, such as how the card was presented.

    Card Security Code Verification

    The verification check performed on the card’s security code:

    • CVV1 – the security code stored in the magnetic stripe on the card.

    • CVV2 – the security code printed on the card.

    • ICVV – the security code stored on the chip of the card.

    • DCVV – a dynamic security code used in some contactless payments when a card or device is tapped against the card reader.

    Cardholder authentication data

    Standin Approval By

    Which party approved the transaction requiring stand-in processing or Commando Mode.

    Transaction Metadata

    Merchant-provided metadata related to the transaction, including details about lodging and transit-related purchases.

    Acting User Token

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

    User Token

    Unique identifier of the user who owns the account that funded the transaction; subsequent related transactions retain the same user_token, even if the card used to complete the transaction moves to another user.

    Card Token

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

    Preceding Related Transaction Token

    Unique identifier of the preceding related transaction, which is useful for identifying the temporary transaction completed by the current transaction.

    For example, authorization, a temporary transaction type, precedes and is completed by authorization.clearing, a final transaction type. In this case, the authorization token is returned with this field. For which transaction types are temporary or final, see Transaction Events in Event Types.

    Incremental Authorization Transaction Tokens

    Incremental authorization transaction tokens, if any.

    Program Transfer

    Information about a program transfer.

    Fee Transfer

    The fee transfer, if any.

    Peer Transfer

    The peer transfer, if any.

    Offer Orders

    Offer orders, if any.

    Rewards

    Rewards, if any.

    Polarity

    Indicates whether the transaction is credit or debit.

    Real Time Fee Group

    Information about a real-time fee group.

    Electronic Commerce Indicator

    The level of verification performed.

    Verification Value Created By

    The transaction participant who determined the verification result.

    Acquirer Fee Amount

    The amount of the acquirer fee. Account holders are sometimes charged an acquirer fee for card use at ATMs, fuel dispensers, etc.

    Issuer Interchange Amount

    The interchange amount from the issuer.

    Network Original Amount

    Network Original Currency Code

Determining the cause of a declined transaction

  • In the sidebar, select Customers > Users and then select the user.

  • Select the Transactions tab or select the Cards tab and then the Card transactions tab to see detailed information about the transaction. Look at the Response Code and Response Memo columns for details about the reason for a declined transaction.

History

The History tab displays a list of operations that have been performed on the user’s account from within the Marqeta portal. All portal users see the three most recent changes. Managers and Admin users can see additional information.

To view all history associated with a user:

  • In the sidebar, select Customers > Users and then select the user.

  • Select the History tab.

    User details

    Is this helpful?

    Yes
    No
  • Select Filter table to search for a transaction or Modify columns to display more columns.

    Field Description

    id

    Automatically assigned unique ID for the action.

    User Name

    The user who performed the operation.

    App Name

    The application used to perform the operation.

    Record Id

    The identifier of the record that was affected.

    Record Operation

    The type of operation performed, such as an update.

    Record Type

    The type of record.

    Program

    The program shortcode.

    Created Time

    The time when the action was created.

    Remote Ip Address

    The remote IP address where the action was generated.

    User Role

    The role of the user who performed the operation.

    Http Status Code

    The status code returned by the action.

    Http Params

    The parameters associated with the request, such as {"first_name":"test","last_name":"test"}.

    Event Type

    The type of event.

    App Server Name

    The application server that generated the action.

    Http Path

    The HTTP path, such as /changepassword or /businesses/search.

    Http Method

    The http method, such as PUT or POST.

    Old Value

    The value before the action.

    New Value

    The value after the action.

    Notes

    Notes related to the action, if any.

    Extra Info

    Additional information about the action, if any.

Notes

Use the Notes tab to view all the notes associated with a user.

To view a user note:

  • In the sidebar, select Customers > Users and then select the user.

  • Select the Notes tab.

    Field Description

    Description

    A description of the note.

    Created By

    The user who created the note.

    Created By User Role

    The role of the user who created the note.

    Private

    Indicates whether the note is private or not.

    Token

    Unique identifier for the note.

To add a note to a user:

  • In the sidebar, select Customers > Users and then select the user.

  • In the upper-right corner, select Add note.

  • In the Add Note window, enter your notes and select Add.

Transitions

Use the Transitions tab to view all the transitions associated with a user.

To view transitions:

  • In Customers > Users, select the user row.

  • Select the Transitions tab.

    Field Description

    Created Time

    The date and time when the transition occurred.

    Status

    The current state.

    Reason Code

    The standard code describing the reason for the transition.

    Reason

    Additional information about the state change.

    Channel

    The mechanism by which the transition was initiated:

    • ADMIN – Indicates that the card transition was initiated through the Marqeta Dashboard.

    • API – Indicates that the card transition was initiated by you through the Core API. Use this value when creating a card transition with an API POST request.

    • FRAUD – Indicates that either Marqeta or the card network has determined that the card is fraudulent.

    • IVR – Indicates that the card transition was initiated through your Interactive Voice Response system.

    • SYSTEM – Indicates that the card transition was initiated by Marqeta. For example, Marqeta suspended the card due to excessive failed PIN attempts.

    Token

    The transition token.

    Last Modified Time

    The date and time when the user was last modified.

Businesses

Use Businesses to monitor and manage businesses in your program. You can manage businesses details, children users and cards, transactions, history, notes, and transitions for businesses.

Businesses

Is this helpful?

Yes
No
Note
Businesses do not have cards attached directly to them. Businesses have children users, and those children users have cards.

Business details

To view details for a business, select the row for the business who details you want to view to open the Business Details tab. The business details tab displays Business Information, Primary Contacts, and Incorporation Status.

Business details

Is this helpful?

Yes
No

Business information

Field Description

Active

Indicates whether the business is active (Active, Limited) or inactive (Unverified, Suspended, Closed).

Status

The business' status, which determines the business' capabilities. To change the status, select Change.

Token

The business' unique identifier.

Name (legal)

The business legal name. Required for KYC verification checks.

Name (DBA)

The fictitious business name. Required for KYC verification checks.

Business phone

The telephone number of the business. Required for KYC verification checks.

Business

The date when the business was established. Required for KYC verification checks.

Office location

Address of the business office. Required for KYC verification checks.

Identifications

Field Description

Taxpayer ID

The business taxpayer ID.

Business type

The type of business, for example, B2B (business-to-business) or B2C (business-to-consumer).

DUNS number

The Data Universal Numbering System (DUNS) number of the business.

Business website

The URL of the business website.

On Location Since

The date on which the business office opened in its current location.

Business description

General description of the business.

Business history

History of the business.

International offices

The locations of the business' offices outside the US.

API note

A note applied on the business object.

Account holder group token

A token that associates the business with a specific account holder group.

IP address

The business' IP address.

Created

The date and time when the business information was created.

Last modified

The date and time when the business information was last updated.

Metadata

Metadata key/value pair, if any. To define metadata, select Add New.

Primary contact

Field Description

Name

The name of the primary contact.

Title

The title of the primary contact.

Department

The department of the primary contact.

Phone

The telephone number of the primary contact.

Extension

The telephone extension of the primary contact.

Mobile phone

The mobile phone of the primary contact.

Fax number

The fax number of the primary contact.

Email

The email address of the primary contact.

Incorporation status

Field Description

Is Public

Indicates whether the business is privately or publicly held.

Incorporation Type

The type of incorporation. Required for verification (KYC) checks.

Can be one of the following identification types: LLC, CORPORATION, SOLE_PROPRIETORSHIP, PARTNERSHIP, COOPERATIVE, OTHER

Name (Registered)

The name under which the business is registered.

State of Incorporation

The state in which the business is incorporated. Required for verification (KYC) checks.

Stock Symbol

The business' stock symbol.

Registered Address

The address under which the business is registered.

Children users

Use Child Users to manage cards associated with a business.

To view children users:

  • From the sidebar, select Customers > Businesses, then select the business. To search for a business, select Filter table.

  • Select the Children Users tab. For details on the Children User fields, see Users.

    Children users

    Is this helpful?

    Yes
    No
  • To modify the columns to display, use the gear button at the right.

Viewing children user details

To view children user details, select the row in the summary view. For more information on children users, see Users.

Changing a business card’s status

You can set a card status to Active, Terminated, or Suspended.

To change a card’s status:

  • From the sidebar, select Customers > Businesses, then select the business. To search for a business, select Filter table.

  • Select the Children Users tab and select the user.

  • Select the Cards tab.

  • Select the vertical ellipses to the right in the row of the card to report and select Change Status.

  • In the window, select the Change button next to the card state.

  • Select the new state, select a reason for the change from the dropdown list, and add any additional notes.

  • Select Save.

Locking a business card

Locking a card temporarily suspends card activity.

To lock a card:

  • From the sidebar, select Customers > Businesses, then select the business. To search for a business, select Filter table.

  • Select the Children Users tab and select the user.

  • Select the Cards tab.

  • Select Lock card.

  • To unlock the card, select Unlock card.

Replacing a business card

When replacing a damaged or expiring card with the same card number, the current card remains active until the new card is activated, at which point the current card is terminated.

To replace a damaged or expiring card:

  • From the sidebar, select Customers > Businesses, then select the business. To search for a business, select Filter table.

  • Select the Children Users tab and select the user.

  • Select the Cards tab.

  • Select Replace card.

  • Send a replacement card to the address under Recipient address in the Replace card window.

  • Select the reason that the card is being replaced.

  • Add any notes for the card transition, if necessary.

  • Select Replace card and reissue.

After a card has been activated, it cannot be returned to Unactivated status.

Reporting a business card lost or stolen

Reporting that a card is lost or stolen terminates the card and reissues a new card with a new PAN, which is digitally available (if virtual) or mailed to the user (if physical). The physical card will be sent to the recipient address on file. Terminated cards cannot be used or reactivated.

To report a business card lost or stolen:

  • From the sidebar, select Customers > Businesses, then select the business. To search for a business, select Filter table.

  • Select the Children Users tab and select the user.

  • In the Cards tab, select the card.

  • From the button at the right of the row of the card to report, select Report Card Lost/Stolen.

Transactions

Use the Transactions tab to view all transactions associated with a business.

To view a business' transactions:

  • From the sidebar, select Customers > Businesses, then select the business. To search for a business, select Filter table.

  • Select the Transactions tab. Use the Filter table button, if necessary. For details on the Transaction fields, see Transactions for users.

    Business transactions

    Is this helpful?

    Yes
    No
  • To modify the columns to display, use the gear button at the right.

History

Use the History tab to view all history associated with a business.

To view a business' history:

  • From the sidebar, select Customers > Businesses, then select the business. To search for a business, select Filter table.

  • Select the History tab.

    Business history

    Is this helpful?

    Yes
    No
  • On the History tab, use the Filter table button if necessary. For details on the displayed information, see History for users.

  • To modify the columns to display, use the gear button at the right.

Notes

Use the Notes tab to view all the notes associated with a business.

To view a business' notes:

  • From the sidebar, select Customers > Businesses, then select the business. To search for a business, select Filter table.

  • Select the Notes tab.

    Business history

    Is this helpful?

    Yes
    No

    The tab includes the following information:

    Field Description

    Description

    A description of the note.

    Created By

    The user who created the note.

    Created By User Role

    The role of the user who created the note.

    Private

    Indicates whether the note is private or not.

    Token

    Unique identifier for the note.

To add a note to a business:

  • From the sidebar, select Customers > Businesses, then select the business. To search for a business, select Filter table.

  • Select Add Note in the upper-right corner.

  • In the Add Note window, enter your note and select Save.

Transitions

Use the Transitions tab to view all transitions associated with a business.

To view transitions:

  • From the sidebar, select Customers > Businesses, then select the business. To search for a business, select Filter table.

  • Select the Transitions tab.

    Business transitions

    Is this helpful?

    Yes
    No

    The tab includes the following information:

    Field Description

    Created Time

    The date and time when the transition occurred.

    Status

    The current status of the transition.

    Reason Code

    The standard code describing the reason for the transition.

    Reason

    Additional information about the state change.

    Channel

    The mechanism by which the transition was initiated:

    • ADMIN – Indicates that the card transition was initiated through the Marqeta Dashboard.

    • API – Indicates that the card transition was initiated by you through the Core API. Use this value when creating a card transition with an API POST request.

    • FRAUD – Indicates that either Marqeta or the card network has determined that the card is fraudulent.

    • IVR – Indicates that the card transition was initiated through your Interactive Voice Response system.

    • SYSTEM – Indicates that the card transition was initiated by Marqeta. For example, Marqeta suspended the card due to excessive failed PIN attempts.

    Token

    The transition token.

    Last Modified Time

    The date and time when the user was last modified.

    Business Token

    The unique identifier for the business.

  • To modify the columns to display, use the gear button at the right.

Join our developer newsletter