GPA Orders

amount

Amount to fund.

decimal

Format:
0.00

business_token

Unique identifier of the business.

Pass either a business_token or a user_token, not both.

Send a GET request to /businesses to retrieve business tokens.

1–36 chars

currency_code

Three-digit ISO 4217 currency code.

Valid three-digit ISO 4217 currency code

fees

List of fees associated with the funding transaction.

Valid array of one or more fees objects

fees[].memo

Additional text that describes the fee.

1–99 chars

fees[].tags

Descriptive metadata about the fee.

255 char max

fees[].token

Unique identifier of the fee.

1–36 chars

funding_source_address_token

Unique identifier of the funding source address to use for this order. If your funding source is an ACH account, then a funding source address is not required. If your funding source is a payment card, you must have at least one funding source address in order to create a GPA order. Send a GET request to /fundingsources/addresses/user/{token} to retrieve addresses for a specific user.

1–36 chars

funding_source_token

Unique identifier of the funding source to use for this order.

You do not have to supply a funding source token value in this call if you have a default funding source set up (verify the funding source’s is_default_account field). If you have only one funding source, then this source is used as the default. If you have multiple funding sources and none are configured as the default, then an error is returned.

Send a GET request to /fundingsources/user/{user_token} to retrieve funding source tokens for a user or to /fundingsources/business/{business_token} to retrieve funding source tokens for a business.

1–36 chars

memo

Additional descriptive text.

1–99 chars

tags

Comma-delimited list of tags describing the GPA order.

1–255 chars

token

Unique identifier of the GPA order.

If you do not include a token, the system will generate one automatically. This token is necessary for use in other calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated.

1–36 chars

user_token

Unique identifier of the user.

Pass either a user_token or a business_token, not both.

Send a GET request to /users to retrieve business tokens.

1–36 chars

amount

Amount funded.

decimal

Format:
0.00

business_token

Unique identifier of the business.

This field is returned if it exists in the resource.

Existing business_token

created_time

Date and time when the GPA order was created, in UTC.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

currency_code

Three-digit ISO 4217 currency code.

Valid three-digit ISO 4217 currency code

fees

List of fees associated with the funding transaction.

This array is returned if it exists in the resource.

Valid array of one or more fees objects

fees[].fee

Contains details about the fee.

active, amount, created_time, currency_code, last_modified_time, name, real_time_assessment, tags, token

fees[].fee.active

Indicates whether the fee is active.

true, false

fees[].fee.amount

Amount of the fee.

decimal

Format:
0.00

fees[].fee.created_time

Date and time when the fees object was created, in UTC.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

fees[].fee.currency_code

Three-digit ISO 4217 currency code.

Valid three-digit ISO 4217 currency code

fees[].fee.last_modified_time

Date and time when the fees object was last modified, in UTC.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

fees[].fee.name

Name of the fee.

50 char max

fees[].fee.real_time_assessment

Controls the assessment of real-time fees.

domestic_enabled, international_enabled, transaction_type

fees[].fee.real_time_assessment.domestic_enabled

Enables fee assessments where the origin of the transaction acquirer is inside the US.

true, false

Default value:
false

fees[].fee.real_time_assessment.international_enabled

Enables fee assessments where the origin of the transaction acquirer is outside the US.

true, false

Default value:
false

fees[].fee.real_time_assessment.transaction_type

Indicates the type of transactions on which the fee is assessed.

authorization, pindebit.atm.withdrawal, pindebit

fees[].fee.tags

Descriptive metadata about the fee.

255 char max

fees[].fee.token

Unique identifier of the fees object.

Existing fees object token

fees[].memo

Additional text that describes the fee transfer.

1–99 chars

fees[].tags

Descriptive metadata about the fee.

255 char max

fees[].token

Unique identifier of the fee.

1–36 chars

fees[].transaction_token

Unique identifier of the fee transaction.

36 char max

funding

Contains funding information for the transaction, including funding amount, type, and time.

amount, gateway_log, source, source_address

funding.amount

Amount of funds loaded into the GPA.

decimal

Format:
0.00

funding.gateway_log

Contains information from the JIT Funding gateway in response to a funding request.

duration, message, order_number, response, timed_out, transaction_id

funding.gateway_log.duration

Length of time in milliseconds that the gateway took to respond to a funding request.

Any integer

funding.gateway_log.message

Message about the status of the funding request. Useful for determining whether it was approved and completed successfully, declined by the gateway, or timed out.

Approved or completed successfully, Declined by gateway, Operation timeout

funding.gateway_log.order_number

Customer order number, same value as transaction.token.

Existing transaction.token value

funding.gateway_log.response

Contains information from the gateway in response to a funding request.

code, data

funding.gateway_log.response.code

Code received from the gateway.

255 char max

funding.gateway_log.response.data

Contains the gateway’s information about the JIT Funding transaction.

jit_funding

funding.gateway_log.response.data.jit_funding

Contains information about the JIT Funding load event, in which funds are loaded into an account.

acting_user_token, address_verification, amount, balances, business_token, decline_reason, incremental_authorization_jit_funding_tokens, memo, method, original_jit_funding_token, tags, token, user_token

funding.gateway_log.response.data.jit_funding.acting_user_token

User who conducted the transaction.

Can be a child user configured to share its parent’s account balance.

36 char max

funding.gateway_log.response.data.jit_funding.address_verification

Contains address verification data used to make JIT funding decisions.

gateway, issuer, request

funding.gateway_log.response.data.jit_funding.address_verification.gateway

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.

on_file, response

funding.gateway_log.response.data.jit_funding.address_verification.gateway.on_file

Contains address verification information.

postal_code, street_address, zip

funding.gateway_log.response.data.jit_funding.address_verification.gateway.on_file.postal_code

Postal code of the address.

10 char max

funding.gateway_log.response.data.jit_funding.address_verification.gateway.on_file.street_address

Street name and number of the address.

40 char max

funding.gateway_log.response.data.jit_funding.address_verification.gateway.on_file.zip

United States ZIP code of the address.

10 char max

funding.gateway_log.response.data.jit_funding.address_verification.gateway.response

Response codes and memos for address verification, card security verification, and transactions.

additional_information, code, memo

funding.gateway_log.response.data.jit_funding.address_verification.gateway.response.additional_information

Information about the velocity control applied to the transaction.

NOTE: This field is returned only in transaction response objects. It is not returned in address verification or card security verification response objects.

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.

funding.gateway_log.response.data.jit_funding.address_verification.gateway.response.code

Four-digit response code for address verification, card security code verification, or transactions.

For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder:

For card security verification, the code indicates whether the verification check passed and can have these possible values:

For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see Transaction response codes.

Four-digit code

funding.gateway_log.response.data.jit_funding.address_verification.gateway.response.memo

Additional text that describes the response.

255 char max

funding.gateway_log.response.data.jit_funding.address_verification.issuer

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.

on_file, response

funding.gateway_log.response.data.jit_funding.address_verification.issuer.on_file

Contains address verification information.

postal_code, street_address, zip

funding.gateway_log.response.data.jit_funding.address_verification.issuer.on_file.postal_code

Postal code of the address.

10 char max

funding.gateway_log.response.data.jit_funding.address_verification.issuer.on_file.street_address

Street name and number of the address.

40 char max

funding.gateway_log.response.data.jit_funding.address_verification.issuer.on_file.zip

United States ZIP code of the address.

10 char max

funding.gateway_log.response.data.jit_funding.address_verification.issuer.response

Response codes and memos for address verification, card security verification, and transactions.

additional_information, code, memo

funding.gateway_log.response.data.jit_funding.address_verification.issuer.response.additional_information

Information about the velocity control applied to the transaction.

NOTE: This field is returned only in transaction response objects. It is not returned in address verification or card security verification response objects.

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.

funding.gateway_log.response.data.jit_funding.address_verification.issuer.response.code

Four-digit response code for address verification, card security code verification, or transactions.

For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder:

For card security verification, the code indicates whether the verification check passed and can have these possible values:

For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see Transaction response codes.

Four-digit code

funding.gateway_log.response.data.jit_funding.address_verification.issuer.response.memo

Additional text that describes the response.

255 char max

funding.gateway_log.response.data.jit_funding.address_verification.request

Contains address verification information.

postal_code, street_address, zip

funding.gateway_log.response.data.jit_funding.address_verification.request.postal_code

Postal code of the address.

10 char max

funding.gateway_log.response.data.jit_funding.address_verification.request.street_address

Street name and number of the address.

40 char max

funding.gateway_log.response.data.jit_funding.address_verification.request.zip

United States ZIP code of the address.

10 char max

funding.gateway_log.response.data.jit_funding.amount

Requested amount of funding.

0 min

Format:
0.00

funding.gateway_log.response.data.jit_funding.balances

Contains the GPA’s balance details.

available_balance, balances, cached_balance, credit_balance, currency_code, impacted_amount, last_updated_time, ledger_balance, pending_credits

funding.gateway_log.response.data.jit_funding.business_token

Holder of the business account that was funded.

36 char max

funding.gateway_log.response.data.jit_funding.decline_reason

Reason why the transaction was declined.

AMOUNT_LIMIT_EXCEEDED, CARD_NOT_ACTIVE, CARDHOLDER_NOT_ACTIVE, CLOSED_ACCOUNT, DUPLICATE_TRANSACTION, EXPIRED_CARD, INSUFFICIENT_FUNDS, INVALID_AMOUNT, INVALID_CARD, INVALID_MERCHANT, NO_CHECKING_ACCOUNT, NO_CREDIT_ACCOUNT, NO_SAVINGS_ACCOUNT, REVOCATION_ALL_AUTHORIZATION_ORDER, REVOCATION_AUTHORIZATION_ORDER, SOFT_DECLINE_AUTHENTICATION_REQUIRED, STOP_PAYMENT, SUSPECTED_FRAUD, TRANSACTION_COUNT_LIMIT_EXCEEDED, TRANSACTION_NOT_PERMITTED

funding.gateway_log.response.data.jit_funding.incremental_authorization_jit_funding_tokens

Array of tokens referencing the JIT Funding tokens of all previous associated incremental authorization JIT Funding requests. Useful for ascertaining the final transaction amount when the original amount was incremented.

Existing incremental authorization JIT Funding tokens

funding.gateway_log.response.data.jit_funding.memo

Additional information that describes the JIT Funding transaction.

99 char max

funding.gateway_log.response.data.jit_funding.method

JIT Funding response type. See The jit_funding object for the purpose, funding event type, and description of each method.

pgfs.adjustment.credit, pgfs.adjustment.debit, pgfs.authorization, pgfs.authorization.account_verification, pgfs.authorization.capture, pgfs.authorization.capture.chargeback, pgfs.authorization.capture.chargeback.reversal, pgfs.authorization.incremental, pgfs.authorization.reversal, pgfs.authorization.standin, pgfs.auth_plus_capture, pgfs.auth_plus_capture.standin, pgfs.balanceinquiry, pgfs.billpayment, pgfs.billpayment.capture, pgfs.billpayment.reversal, pgfs.directdeposit.credit, pgfs.directdeposit.credit.reversal, pgfs.directdeposit.debit, pgfs.directdeposit.debit.reversal, pgfs.dispute.credit, pgfs.dispute.debit, pgfs.force_capture, pgfs.network.load, pgfs.original.credit.authorization, pgfs.original.credit.auth_plus_capture, pgfs.pindebit.chargeback, pgfs.pindebit.chargeback.reversal, pgfs.refund, pgfs.refund.authorization, pgfs.refund.authorization.reversal

funding.gateway_log.response.data.jit_funding.original_jit_funding_token

Unique identifier of the first associated JIT Funding message. Useful for correlating related JIT Funding messages (that is, those associated with the same GPA order). Not included in the first of any set of related messages.

36 char max

funding.gateway_log.response.data.jit_funding.tags

Customer-defined tags related to the JIT Funding transaction.

255 char max

funding.gateway_log.response.data.jit_funding.token

Existing JIT Funding token matching the funding.gateway_log.transaction_id field of the associated GPA order.

NOTE: The transaction_id field updates if a subsequent JIT Funding message associated with that GPA order is sent. If multiple JIT Funding messages are associated with the same GPA order, the transaction_id field matches the token of the most recent message.

36 char max

funding.gateway_log.response.data.jit_funding.user_token

Holder of the user account that was funded.

36 char max

funding.gateway_log.timed_out

Whether the gateway sent a response (true) or timed out (false).

true, false

funding.gateway_log.transaction_id

Customer-defined identifier for the transaction.

255 char max

funding.source

Contains funding source information for the transaction, including the funding type and time.

active, created_time, is_default_account, last_modified_time, token, type

funding.source.active

Whether the funding source is active.

true, false

funding.source.created_time

Date and time when the funding source was created, in UTC.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

funding.source.is_default_account

Whether the GPA order unload’s funding source is the default funding account.

true, false

funding.source.last_modified_time

Date and time when the funding source was last modified, in UTC.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

funding.source.token

Unique identifier of the funding source.

Format: UUID

funding.source.type

Funding type of the funding source.

ach, paymentcard

funding.source_address

Contains information about the billing address of the funding source.

active, address_1, address_2, business_token, city, country, created_time, first_name, is_default_address, last_modified_time, last_name, phone, postal_code, state, token, user_token, zip

funding.source_address.active

Whether the address is active.

true, false

funding.source_address.address_1

Street address of the funding source.

255 char max

funding.source_address.address_2

Additional address information for the funding source.

This field is returned if it exists in the resource.

255 char max

funding.source_address.business_token

Unique identifier of the business account holder associated with the address.

This field is returned if it exists in the resource.

1–36 chars

funding.source_address.city

City of the funding source.

40 char max

funding.source_address.country

Country of the funding source.

1–40 chars

funding.source_address.created_time

Date and time when the address was created, in UTC.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

funding.source_address.first_name

First name of the account holder associated with the funding source.

40 char max

funding.source_address.is_default_address

Whether this address is the default address used by the funding source.

true, false

funding.source_address.last_modified_time

Date and time when the address was last modified, in UTC.

This field is returned if it exists in the resource.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

funding.source_address.last_name

Last name of the account holder associated with the funding source.

40 char max

funding.source_address.phone

Phone number of the funding source.

This field is returned if it exists in the resource.

255 char max

funding.source_address.postal_code

Postal code of the funding source.

10 char max

funding.source_address.state

Two-character state, province, or territorial abbreviation.

For the complete list, see Valid state, provincial, and territorial abbreviations.

2 char max

funding.source_address.token

Unique identifier of the funding_source_address object.

1–36 chars

funding.source_address.user_token

Unique identifier of the user account holder associated with the address.

This field is returned if it exists in the resource.

1–36 chars

funding.source_address.zip

United States ZIP code of the funding source.

10 char max

funding_source_address_token

Unique identifier of the funding source address to use for this order.

Existing funding_source_address token

funding_source_token

Unique identifier of the funding source to use for this order.

Existing funding_source token

gateway_message

Message about the status of the funding request. Useful for determining whether it was approved and completed successfully, declined by the gateway, or timed out.

This field is returned if it exists in the resource.

Approved or completed successfully, Declined by gateway, Operation timeout

gateway_token

Unique identifier of the JIT Funding request and response.

This field is returned if it exists in the resource.

Existing gateway_token

jit_funding

Contains information about the JIT Funding load event, in which funds are loaded into an account.

acting_user_token, address_verification, amount, balances, business_token, decline_reason, incremental_authorization_jit_funding_tokens, memo, method, original_jit_funding_token, tags, token, user_token

jit_funding.acting_user_token

User who conducted the transaction.

Can be a child user configured to share its parent’s account balance.

36 char max

jit_funding.address_verification

Contains address verification data used to make JIT funding decisions.

gateway, issuer, request

jit_funding.address_verification.gateway

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.

on_file, response

jit_funding.address_verification.gateway.on_file

Contains address verification information.

postal_code, street_address, zip

jit_funding.address_verification.gateway.on_file.postal_code

Postal code of the address.

10 char max

jit_funding.address_verification.gateway.on_file.street_address

Street name and number of the address.

40 char max

jit_funding.address_verification.gateway.on_file.zip

United States ZIP code of the address.

10 char max

jit_funding.address_verification.gateway.response

Response codes and memos for address verification, card security verification, and transactions.

additional_information, code, memo

jit_funding.address_verification.gateway.response.additional_information

Information about the velocity control applied to the transaction.

NOTE: This field is returned only in transaction response objects. It is not returned in address verification or card security verification response objects.

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.

jit_funding.address_verification.gateway.response.code

Four-digit response code for address verification, card security code verification, or transactions.

For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder:

For card security verification, the code indicates whether the verification check passed and can have these possible values:

For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see Transaction response codes.

Four-digit code

jit_funding.address_verification.gateway.response.memo

Additional text that describes the response.

255 char max

jit_funding.address_verification.issuer

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.

on_file, response

jit_funding.address_verification.issuer.on_file

Contains address verification information.

postal_code, street_address, zip

jit_funding.address_verification.issuer.on_file.postal_code

Postal code of the address.

10 char max

jit_funding.address_verification.issuer.on_file.street_address

Street name and number of the address.

40 char max

jit_funding.address_verification.issuer.on_file.zip

United States ZIP code of the address.

10 char max

jit_funding.address_verification.issuer.response

Response codes and memos for address verification, card security verification, and transactions.

additional_information, code, memo

jit_funding.address_verification.issuer.response.additional_information

Information about the velocity control applied to the transaction.

NOTE: This field is returned only in transaction response objects. It is not returned in address verification or card security verification response objects.

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.

jit_funding.address_verification.issuer.response.code

Four-digit response code for address verification, card security code verification, or transactions.

For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder:

For card security verification, the code indicates whether the verification check passed and can have these possible values:

For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see Transaction response codes.

Four-digit code

jit_funding.address_verification.issuer.response.memo

Additional text that describes the response.

255 char max

jit_funding.address_verification.request

Contains address verification information.

postal_code, street_address, zip

jit_funding.address_verification.request.postal_code

Postal code of the address.

10 char max

jit_funding.address_verification.request.street_address

Street name and number of the address.

40 char max

jit_funding.address_verification.request.zip

United States ZIP code of the address.

10 char max

jit_funding.amount

Requested amount of funding.

0 min

Format:
0.00

jit_funding.balances

Contains the GPA’s balance details.

available_balance, balances, cached_balance, credit_balance, currency_code, impacted_amount, last_updated_time, ledger_balance, pending_credits

jit_funding.business_token

Holder of the business account that was funded.

36 char max

jit_funding.decline_reason

Reason why the transaction was declined.

AMOUNT_LIMIT_EXCEEDED, CARD_NOT_ACTIVE, CARDHOLDER_NOT_ACTIVE, CLOSED_ACCOUNT, DUPLICATE_TRANSACTION, EXPIRED_CARD, INSUFFICIENT_FUNDS, INVALID_AMOUNT, INVALID_CARD, INVALID_MERCHANT, NO_CHECKING_ACCOUNT, NO_CREDIT_ACCOUNT, NO_SAVINGS_ACCOUNT, REVOCATION_ALL_AUTHORIZATION_ORDER, REVOCATION_AUTHORIZATION_ORDER, SOFT_DECLINE_AUTHENTICATION_REQUIRED, STOP_PAYMENT, SUSPECTED_FRAUD, TRANSACTION_COUNT_LIMIT_EXCEEDED, TRANSACTION_NOT_PERMITTED

jit_funding.incremental_authorization_jit_funding_tokens

Array of tokens referencing the JIT Funding tokens of all previous associated incremental authorization JIT Funding requests. Useful for ascertaining the final transaction amount when the original amount was incremented.

Existing incremental authorization JIT Funding tokens

jit_funding.memo

Additional information that describes the JIT Funding transaction.

99 char max

jit_funding.method

JIT Funding response type. See The jit_funding object for the purpose, funding event type, and description of each method.

pgfs.adjustment.credit, pgfs.adjustment.debit, pgfs.authorization, pgfs.authorization.account_verification, pgfs.authorization.capture, pgfs.authorization.capture.chargeback, pgfs.authorization.capture.chargeback.reversal, pgfs.authorization.incremental, pgfs.authorization.reversal, pgfs.authorization.standin, pgfs.auth_plus_capture, pgfs.auth_plus_capture.standin, pgfs.balanceinquiry, pgfs.billpayment, pgfs.billpayment.capture, pgfs.billpayment.reversal, pgfs.directdeposit.credit, pgfs.directdeposit.credit.reversal, pgfs.directdeposit.debit, pgfs.directdeposit.debit.reversal, pgfs.dispute.credit, pgfs.dispute.debit, pgfs.force_capture, pgfs.network.load, pgfs.original.credit.authorization, pgfs.original.credit.auth_plus_capture, pgfs.pindebit.chargeback, pgfs.pindebit.chargeback.reversal, pgfs.refund, pgfs.refund.authorization, pgfs.refund.authorization.reversal

jit_funding.original_jit_funding_token

Unique identifier of the first associated JIT Funding message. Useful for correlating related JIT Funding messages (that is, those associated with the same GPA order). Not included in the first of any set of related messages.

36 char max

jit_funding.tags

Customer-defined tags related to the JIT Funding transaction.

255 char max

jit_funding.token

Existing JIT Funding token matching the funding.gateway_log.transaction_id field of the associated GPA order.

NOTE: The transaction_id field updates if a subsequent JIT Funding message associated with that GPA order is sent. If multiple JIT Funding messages are associated with the same GPA order, the transaction_id field matches the token of the most recent message.

36 char max

jit_funding.user_token

Holder of the user account that was funded.

36 char max

last_modified_time

Date and time when the GPA order was last modified, in UTC.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

memo

Additional descriptive text.

This field is returned if it exists in the resource.

99 char max

response

Response codes and memos for address verification, card security verification, and transactions.

additional_information, code, memo

response.additional_information

Information about the velocity control applied to the transaction.

NOTE: This field is returned only in transaction response objects. It is not returned in address verification or card security verification response objects.

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.

response.code

Four-digit response code for address verification, card security code verification, or transactions.

For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder:

For card security verification, the code indicates whether the verification check passed and can have these possible values:

For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see Transaction response codes.

Four-digit code

response.memo

Additional text that describes the response.

255 char max

state

Current status of the funding transaction.

PENDING, CLEARED, COMPLETION, DECLINED, ERROR, ALL

tags

Comma-delimited list of tags describing the GPA order.

This field is returned if it exists in the resource.

255 char max

token

Unique identifier of the GPA order.

36 char max

transaction_token

Unique identifier of the transaction being funded.

Format: UUID

user_token

Unique identifier of the user resource.

This field is returned if it exists in the resource.

Existing user resource token

token

Unique identifier of the GPA order.

Send a GET request to /transactions?type=gpa.credit to retrieve GPA order tokens.

Existing GPA order token

amount

Amount funded.

decimal

Format:
0.00

business_token

Unique identifier of the business.

This field is returned if it exists in the resource.

Existing business_token

created_time

Date and time when the GPA order was created, in UTC.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

currency_code

Three-digit ISO 4217 currency code.

Valid three-digit ISO 4217 currency code

fees

List of fees associated with the funding transaction.

This array is returned if it exists in the resource.

Valid array of one or more fees objects

fees[].fee

Contains details about the fee.

active, amount, created_time, currency_code, last_modified_time, name, real_time_assessment, tags, token

fees[].fee.active

Indicates whether the fee is active.

true, false

fees[].fee.amount

Amount of the fee.

decimal

Format:
0.00

fees[].fee.created_time

Date and time when the fees object was created, in UTC.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

fees[].fee.currency_code

Three-digit ISO 4217 currency code.

Valid three-digit ISO 4217 currency code

fees[].fee.last_modified_time

Date and time when the fees object was last modified, in UTC.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

fees[].fee.name

Name of the fee.

50 char max

fees[].fee.real_time_assessment

Controls the assessment of real-time fees.

domestic_enabled, international_enabled, transaction_type

fees[].fee.real_time_assessment.domestic_enabled

Enables fee assessments where the origin of the transaction acquirer is inside the US.

true, false

Default value:
false

fees[].fee.real_time_assessment.international_enabled

Enables fee assessments where the origin of the transaction acquirer is outside the US.

true, false

Default value:
false

fees[].fee.real_time_assessment.transaction_type

Indicates the type of transactions on which the fee is assessed.

authorization, pindebit.atm.withdrawal, pindebit

fees[].fee.tags

Descriptive metadata about the fee.

255 char max

fees[].fee.token

Unique identifier of the fees object.

Existing fees object token

fees[].memo

Additional text that describes the fee transfer.

1–99 chars

fees[].tags

Descriptive metadata about the fee.

255 char max

fees[].token

Unique identifier of the fee.

1–36 chars

fees[].transaction_token

Unique identifier of the fee transaction.

36 char max

funding

Contains funding information for the transaction, including funding amount, type, and time.

amount, gateway_log, source, source_address

funding.amount

Amount of funds loaded into the GPA.

decimal

Format:
0.00

funding.gateway_log

Contains information from the JIT Funding gateway in response to a funding request.

duration, message, order_number, response, timed_out, transaction_id

funding.gateway_log.duration

Length of time in milliseconds that the gateway took to respond to a funding request.

Any integer

funding.gateway_log.message

Message about the status of the funding request. Useful for determining whether it was approved and completed successfully, declined by the gateway, or timed out.

Approved or completed successfully, Declined by gateway, Operation timeout

funding.gateway_log.order_number

Customer order number, same value as transaction.token.

Existing transaction.token value

funding.gateway_log.response

Contains information from the gateway in response to a funding request.

code, data

funding.gateway_log.response.code

Code received from the gateway.

255 char max

funding.gateway_log.response.data

Contains the gateway’s information about the JIT Funding transaction.

jit_funding

funding.gateway_log.response.data.jit_funding

Contains information about the JIT Funding load event, in which funds are loaded into an account.

acting_user_token, address_verification, amount, balances, business_token, decline_reason, incremental_authorization_jit_funding_tokens, memo, method, original_jit_funding_token, tags, token, user_token

funding.gateway_log.response.data.jit_funding.acting_user_token

User who conducted the transaction.

Can be a child user configured to share its parent’s account balance.

36 char max

funding.gateway_log.response.data.jit_funding.address_verification

Contains address verification data used to make JIT funding decisions.

gateway, issuer, request

funding.gateway_log.response.data.jit_funding.address_verification.gateway

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.

on_file, response

funding.gateway_log.response.data.jit_funding.address_verification.gateway.on_file

Contains address verification information.

postal_code, street_address, zip

funding.gateway_log.response.data.jit_funding.address_verification.gateway.on_file.postal_code

Postal code of the address.

10 char max

funding.gateway_log.response.data.jit_funding.address_verification.gateway.on_file.street_address

Street name and number of the address.

40 char max

funding.gateway_log.response.data.jit_funding.address_verification.gateway.on_file.zip

United States ZIP code of the address.

10 char max

funding.gateway_log.response.data.jit_funding.address_verification.gateway.response

Response codes and memos for address verification, card security verification, and transactions.

additional_information, code, memo

funding.gateway_log.response.data.jit_funding.address_verification.gateway.response.additional_information

Information about the velocity control applied to the transaction.

NOTE: This field is returned only in transaction response objects. It is not returned in address verification or card security verification response objects.

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.

funding.gateway_log.response.data.jit_funding.address_verification.gateway.response.code

Four-digit response code for address verification, card security code verification, or transactions.

For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder:

For card security verification, the code indicates whether the verification check passed and can have these possible values:

For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see Transaction response codes.

Four-digit code

funding.gateway_log.response.data.jit_funding.address_verification.gateway.response.memo

Additional text that describes the response.

255 char max

funding.gateway_log.response.data.jit_funding.address_verification.issuer

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.

on_file, response

funding.gateway_log.response.data.jit_funding.address_verification.issuer.on_file

Contains address verification information.

postal_code, street_address, zip

funding.gateway_log.response.data.jit_funding.address_verification.issuer.on_file.postal_code

Postal code of the address.

10 char max

funding.gateway_log.response.data.jit_funding.address_verification.issuer.on_file.street_address

Street name and number of the address.

40 char max

funding.gateway_log.response.data.jit_funding.address_verification.issuer.on_file.zip

United States ZIP code of the address.

10 char max

funding.gateway_log.response.data.jit_funding.address_verification.issuer.response

Response codes and memos for address verification, card security verification, and transactions.

additional_information, code, memo

funding.gateway_log.response.data.jit_funding.address_verification.issuer.response.additional_information

Information about the velocity control applied to the transaction.

NOTE: This field is returned only in transaction response objects. It is not returned in address verification or card security verification response objects.

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.

funding.gateway_log.response.data.jit_funding.address_verification.issuer.response.code

Four-digit response code for address verification, card security code verification, or transactions.

For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder:

For card security verification, the code indicates whether the verification check passed and can have these possible values:

For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see Transaction response codes.

Four-digit code

funding.gateway_log.response.data.jit_funding.address_verification.issuer.response.memo

Additional text that describes the response.

255 char max

funding.gateway_log.response.data.jit_funding.address_verification.request

Contains address verification information.

postal_code, street_address, zip

funding.gateway_log.response.data.jit_funding.address_verification.request.postal_code

Postal code of the address.

10 char max

funding.gateway_log.response.data.jit_funding.address_verification.request.street_address

Street name and number of the address.

40 char max

funding.gateway_log.response.data.jit_funding.address_verification.request.zip

United States ZIP code of the address.

10 char max

funding.gateway_log.response.data.jit_funding.amount

Requested amount of funding.

0 min

Format:
0.00

funding.gateway_log.response.data.jit_funding.balances

Contains the GPA’s balance details.

available_balance, balances, cached_balance, credit_balance, currency_code, impacted_amount, last_updated_time, ledger_balance, pending_credits

funding.gateway_log.response.data.jit_funding.business_token

Holder of the business account that was funded.

36 char max

funding.gateway_log.response.data.jit_funding.decline_reason

Reason why the transaction was declined.

AMOUNT_LIMIT_EXCEEDED, CARD_NOT_ACTIVE, CARDHOLDER_NOT_ACTIVE, CLOSED_ACCOUNT, DUPLICATE_TRANSACTION, EXPIRED_CARD, INSUFFICIENT_FUNDS, INVALID_AMOUNT, INVALID_CARD, INVALID_MERCHANT, NO_CHECKING_ACCOUNT, NO_CREDIT_ACCOUNT, NO_SAVINGS_ACCOUNT, REVOCATION_ALL_AUTHORIZATION_ORDER, REVOCATION_AUTHORIZATION_ORDER, SOFT_DECLINE_AUTHENTICATION_REQUIRED, STOP_PAYMENT, SUSPECTED_FRAUD, TRANSACTION_COUNT_LIMIT_EXCEEDED, TRANSACTION_NOT_PERMITTED

funding.gateway_log.response.data.jit_funding.incremental_authorization_jit_funding_tokens

Array of tokens referencing the JIT Funding tokens of all previous associated incremental authorization JIT Funding requests. Useful for ascertaining the final transaction amount when the original amount was incremented.

Existing incremental authorization JIT Funding tokens

funding.gateway_log.response.data.jit_funding.memo

Additional information that describes the JIT Funding transaction.

99 char max

funding.gateway_log.response.data.jit_funding.method

JIT Funding response type. See The jit_funding object for the purpose, funding event type, and description of each method.

pgfs.adjustment.credit, pgfs.adjustment.debit, pgfs.authorization, pgfs.authorization.account_verification, pgfs.authorization.capture, pgfs.authorization.capture.chargeback, pgfs.authorization.capture.chargeback.reversal, pgfs.authorization.incremental, pgfs.authorization.reversal, pgfs.authorization.standin, pgfs.auth_plus_capture, pgfs.auth_plus_capture.standin, pgfs.balanceinquiry, pgfs.billpayment, pgfs.billpayment.capture, pgfs.billpayment.reversal, pgfs.directdeposit.credit, pgfs.directdeposit.credit.reversal, pgfs.directdeposit.debit, pgfs.directdeposit.debit.reversal, pgfs.dispute.credit, pgfs.dispute.debit, pgfs.force_capture, pgfs.network.load, pgfs.original.credit.authorization, pgfs.original.credit.auth_plus_capture, pgfs.pindebit.chargeback, pgfs.pindebit.chargeback.reversal, pgfs.refund, pgfs.refund.authorization, pgfs.refund.authorization.reversal

funding.gateway_log.response.data.jit_funding.original_jit_funding_token

Unique identifier of the first associated JIT Funding message. Useful for correlating related JIT Funding messages (that is, those associated with the same GPA order). Not included in the first of any set of related messages.

36 char max

funding.gateway_log.response.data.jit_funding.tags

Customer-defined tags related to the JIT Funding transaction.

255 char max

funding.gateway_log.response.data.jit_funding.token

Existing JIT Funding token matching the funding.gateway_log.transaction_id field of the associated GPA order.

NOTE: The transaction_id field updates if a subsequent JIT Funding message associated with that GPA order is sent. If multiple JIT Funding messages are associated with the same GPA order, the transaction_id field matches the token of the most recent message.

36 char max

funding.gateway_log.response.data.jit_funding.user_token

Holder of the user account that was funded.

36 char max

funding.gateway_log.timed_out

Whether the gateway sent a response (true) or timed out (false).

true, false

funding.gateway_log.transaction_id

Customer-defined identifier for the transaction.

255 char max

funding.source

Contains funding source information for the transaction, including the funding type and time.

active, created_time, is_default_account, last_modified_time, token, type

funding.source.active

Whether the funding source is active.

true, false

funding.source.created_time

Date and time when the funding source was created, in UTC.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

funding.source.is_default_account

Whether the GPA order unload’s funding source is the default funding account.

true, false

funding.source.last_modified_time

Date and time when the funding source was last modified, in UTC.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

funding.source.token

Unique identifier of the funding source.

Format: UUID

funding.source.type

Funding type of the funding source.

ach, paymentcard

funding.source_address

Contains information about the billing address of the funding source.

active, address_1, address_2, business_token, city, country, created_time, first_name, is_default_address, last_modified_time, last_name, phone, postal_code, state, token, user_token, zip

funding.source_address.active

Whether the address is active.

true, false

funding.source_address.address_1

Street address of the funding source.

255 char max

funding.source_address.address_2

Additional address information for the funding source.

This field is returned if it exists in the resource.

255 char max

funding.source_address.business_token

Unique identifier of the business account holder associated with the address.

This field is returned if it exists in the resource.

1–36 chars

funding.source_address.city

City of the funding source.

40 char max

funding.source_address.country

Country of the funding source.

1–40 chars

funding.source_address.created_time

Date and time when the address was created, in UTC.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

funding.source_address.first_name

First name of the account holder associated with the funding source.

40 char max

funding.source_address.is_default_address

Whether this address is the default address used by the funding source.

true, false

funding.source_address.last_modified_time

Date and time when the address was last modified, in UTC.

This field is returned if it exists in the resource.

datetime

Format:
yyyy-MM-ddThh:mm:ssZ

funding.source_address.last_name

Last name of the account holder associated with the funding source.

40 char max

funding.source_address.phone

Phone number of the funding source.

This field is returned if it exists in the resource.

255 char max

funding.source_address.postal_code

Postal code of the funding source.

10 char max

funding.source_address.state

Two-character state, province, or territorial abbreviation.

For the complete list, see Valid state, provincial, and territorial abbreviations.

2 char max

funding.source_address.token

Unique identifier of the funding_source_address object.

1–36 chars

funding.source_address.user_token

Unique identifier of the user account holder associated with the address.

This field is returned if it exists in the resource.

1–36 chars

funding.source_address.zip

United States ZIP code of the funding source.

10 char max

funding_source_address_token

Unique identifier of the funding source address to use for this order.

Existing funding_source_address token

funding_source_token

Unique identifier of the funding source to use for this order.

Existing funding_source token

gateway_message

Message about the status of the funding request. Useful for determining whether it was approved and completed successfully, declined by the gateway, or timed out.

This field is returned if it exists in the resource.

Approved or completed successfully, Declined by gateway, Operation timeout

gateway_token

Unique identifier of the JIT Funding request and response.

This field is returned if it exists in the resource.

Existing gateway_token

jit_funding

Contains information about the JIT Funding load event, in which funds are loaded into an account.

acting_user_token, address_verification, amount, balances, business_token, decline_reason, incremental_authorization_jit_funding_tokens, memo, method, original_jit_funding_token, tags, token, user_token

jit_funding.acting_user_token

User who conducted the transaction.

Can be a child user configured to share its parent’s account balance.

36 char max

jit_funding.address_verification

Contains address verification data used to make JIT funding decisions.

gateway, issuer, request

jit_funding.address_verification.gateway

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.

on_file, response

jit_funding.address_verification.gateway.on_file

Contains address verification information.

postal_code, street_address, zip

jit_funding.address_verification.gateway.on_file.postal_code

Postal code of the address.

10 char max

jit_funding.address_verification.gateway.on_file.street_address

Street name and number of the address.

40 char max

jit_funding.address_verification.gateway.on_file.zip

United States ZIP code of the address.

10 char max

jit_funding.address_verification.gateway.response

Response codes and memos for address verification, card security verification, and transactions.

additional_information, code, memo

jit_funding.address_verification.gateway.response.additional_information

Information about the velocity control applied to the transaction.

NOTE: This field is returned only in transaction response objects. It is not returned in address verification or card security verification response objects.

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.

jit_funding.address_verification.gateway.response.code

Four-digit response code for address verification, card security code verification, or transactions.

For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder:

For card security verification, the code indicates whether the verification check passed and can have these possible values:

For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see Transaction response codes.

Four-digit code

jit_funding.address_verification.gateway.response.memo

Additional text that describes the response.

255 char max

jit_funding.address_verification.issuer

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.

on_file, response

jit_funding.address_verification.issuer.on_file

Contains address verification information.

postal_code, street_address, zip

jit_funding.address_verification.issuer.on_file.postal_code

Postal code of the address.

10 char max

jit_funding.address_verification.issuer.on_file.street_address

Street name and number of the address.

40 char max

jit_funding.address_verification.issuer.on_file.zip

United States ZIP code of the address.

10 char max

jit_funding.address_verification.issuer.response

Response codes and memos for address verification, card security verification, and transactions.

additional_information, code, memo

jit_funding.address_verification.issuer.response.additional_information

Information about the velocity control applied to the transaction.

NOTE: This field is returned only in transaction response objects. It is not returned in address verification or card security verification response objects.

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.

jit_funding.address_verification.issuer.response.code

Four-digit response code for address verification, card security code verification, or transactions.

For address verification responses, the code is an assertion by the Marqeta platform as to whether its address verification data matches that provided by the cardholder:

For card security verification, the code indicates whether the verification check passed and can have these possible values:

For a transaction, the code describes the outcome of the attempted transaction. For the full list of transaction codes, see Transaction response codes.

Four-digit code

jit_funding.address_verification.issuer.response.memo