> ## Documentation Index > Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # GPA Orders > Learn how to move funds into a user's account, or into your program's fees account, using the general purpose account orders object. export const EndpointCard = ({method = "API", title, children, href, arrow = true}) => { const METHOD_STYLES = { GET: { bg: "mint-bg-green-400/20 dark:mint-bg-green-400/20", text: "mint-text-green-700 dark:mint-text-green-400", border: "mint-border-green-300 dark:mint-border-green-700" }, POST: { bg: "mint-bg-blue-400/20 dark:mint-bg-blue-400/20", text: "mint-text-blue-700 dark:mint-text-blue-400" }, PUT: { bg: "mint-bg-yellow-400/20 dark:mint-bg-yellow-400/20", text: "mint-text-yellow-700 dark:mint-text-yellow-400" }, PATCH: { bg: "mint-bg-orange-400/20 dark:mint-bg-orange-400/20", text: "mint-text-orange-700 dark:mint-text-orange-400" }, DELETE: { bg: "mint-bg-red-400/20 dark:mint-bg-red-400/20", text: "mint-text-red-700 dark:mint-text-red-400" }, API: { bg: "mint-bg-black", text: "mint-text-white" } }; const MethodBadge = ({method}) => { const style = METHOD_STYLES[method?.toUpperCase()] ?? METHOD_STYLES.GET; return {method?.toUpperCase()} ; }; const content =
{}
{}

{title}

{children &&

{children}

}
; if (!href) return content; return {content} ; }; The `/gpaorders` endpoint moves funds from a funding source into an account holder’s general-purpose account (GPA). GPA orders can also be used to move funds from an account holder’s funding source into your program’s fee account. GPA orders can be funded by the account holder or your program.

Create GPA order

**Action:** `POST`\ **Endpoint:** `/gpaorders` {/* */} Use this endpoint to create an order to fund an account holder’s GPA. You can assess a [fee](/core-api/fees/) while funding a GPA by using the optional `fees` array to attach one or more fee resources to the GPA order. When you create a GPA order, the GPA is first credited for the fees, then debited at funding time.

Request body

| Fields | Description | | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | amount

decimal

Required | Amount to fund.

**Allowable Values:**

decimal

**Format:**
0.00 | | business\_token

string

Optional | 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.

**Allowable Values:**

1–36 chars | | currency\_code

string

Required | Three-digit ISO 4217 currency code.

**Allowable Values:**

Valid three-digit ISO 4217 currency code | | fees

array of objects

Optional | List of fees associated with the funding transaction.

**Allowable Values:**

Valid array of one or more fees objects | | fees\[].**memo**

string

Optional | Additional text describing the fee.

**Allowable Values:**

1–255 chars | | fees\[].**overrideAmount**

decimal

Optional | Dynamic fee amount that overrides the fee.amount field value.

**Allowable Values:**

decimal

**Format:**
0.00 | | fees\[].**tags**

string

Optional | Descriptive metadata about the fee.

**Allowable Values:**

255 char max | | fees\[].**token**

string

Required | Unique identifier of the fee.

**Allowable Values:**

1–36 chars | | funding\_source\_address\_token

string

Optional | 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.

**Allowable Values:**

1–36 chars | | funding\_source\_token

string

Required | 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.

**Allowable Values:**

1–36 chars | | memo

string

Optional | Additional descriptive text.

**Allowable Values:**

1–99 chars | | tags

string

Optional | Comma-delimited list of tags describing the GPA order.

**Allowable Values:**

1–255 chars | | token

string

Optional | 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.

**Allowable Values:**

1–36 chars | | user\_token

string

Optional | 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.

**Allowable Values:**

1–36 chars | | source\_load\_type

string

Optional | Unique identifier of how the funding source is loaded.

This field is only available for specific card programs. For more information, contact your Marqeta representative.

**Allowable Values:**

ach, otc, debitcard, promotion, earnedwageaccess |

Sample request body

```json JSON lines wrap theme={null} { "token": "my_gpaorder_01", "user_token": "my_user_01", "source_load_type": "ach", "amount": 1000, "currency_code": "USD", "funding_source_token": "my_program_funding_source_01" } ```

Response body

| Fields | Description | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | amount

decimal

Returned | Amount funded.

**Allowable Values:**

decimal

**Format:**
0.00 | | business\_token

string

Conditionally returned | Unique identifier of the business.

This field is returned if it exists in the resource.

**Allowable Values:**

Existing business\_token | | created\_time

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | currency\_code

string

Returned | Three-digit ISO 4217 currency code.

**Allowable Values:**

Valid three-digit ISO 4217 currency code | | fees

array of objects

Conditionally returned | List of fees associated with the funding transaction.

This array is returned if it exists in the resource.

**Allowable Values:**

Valid array of one or more fees objects | | fees\[].**fee**

object

Returned | Contains details about the fee.

**Allowable Values:**

amount, created\_time, currency\_code, last\_modified\_time, name, tags, token | | fees\[].fee.**amount**

decimal

Returned | Amount of the fee.

**Allowable Values:**

decimal

**Format:**
0.00 | | fees\[].fee.**created\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | fees\[].fee.**currency\_code**

string

Returned | Three-digit ISO 4217 currency code.

**Allowable Values:**

Valid three-digit ISO 4217 currency code | | fees\[].fee.**last\_modified\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | fees\[].fee.**name**

string

Returned | Name of the fee.

**Allowable Values:**

50 char max | | fees\[].fee.**tags**

string

Conditionally returned | Descriptive metadata about the fee.

**Allowable Values:**

255 char max | | fees\[].fee.**token**

string

Returned | Unique identifier of the fees object.

**Allowable Values:**

Existing fees object token | | fees\[].**memo**

string

Conditionally returned | Additional text describing the fee.

**Allowable Values:**

1–255 chars | | fees\[].**overrideAmount**

decimal

Conditionally returned | Dynamic fee amount that overrides the fee.amount field value.

**Allowable Values:**

decimal

**Format:**
0.00 | | fees\[].**tags**

string

Conditionally returned | Descriptive metadata about the fee.

**Allowable Values:**

255 char max | | fees\[].**token**

string

Returned | Unique identifier of the fee.

**Allowable Values:**

1–36 chars | | fees\[].**transaction\_token**

string

Returned | Unique identifier of the fee transaction.

**Allowable Values:**

36 char max | | funding

object

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

**Allowable Values:**

amount, gateway\_log, source, source\_address | | funding.**amount**

decimal

Conditionally returned | Amount of funds loaded into the GPA.

**Allowable Values:**

decimal

**Format:**
0.00 | | funding.**gateway\_log**

object

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

**Allowable Values:**

duration, message, order\_number, response, timed\_out, transaction\_id | | funding.gateway\_log.**duration**

integer

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

**Allowable Values:**

Any integer | | funding.gateway\_log.**message**

string

Returned | 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.

**Allowable Values:**

Approved or completed successfully, Declined by gateway, Operation timeout | | funding.gateway\_log.**order\_number**

string

Returned | Customer order number, same value as transaction.token.

**Allowable Values:**

Existing transaction.token value | | funding.gateway\_log.**response**

object

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

**Allowable Values:**

code, data | | funding.gateway\_log.response.**code**

string

Returned | Code received from the gateway.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.**data**

object

Conditionally returned | Contains the gateway’s information about the JIT Funding transaction.

**Allowable Values:**

jit\_funding | | funding.gateway\_log.response.data.**jit\_funding**

object

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

This object is returned if your program uses JIT Funding.

**Allowable Values:**

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**

string

Conditionally returned | User who conducted the transaction.

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

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**address\_verification**

object

Conditionally returned | Contains address verification data used to make JIT Funding decisions.

**Allowable Values:**

gateway, issuer, request | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**gateway**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**issuer**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**request**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.**jit\_account\_name\_verification**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions from one of the following objects:

- The gateway object, which contains account name verification data from your JIT Funding gateway.
- The issuer object, which contains account name verification data from the Marqeta platform.
- The request object, which contains account name verification data as it appears in a JIT Funding request.

**Allowable Values:**

gateway, issuer, request | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**gateway**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**issuer**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**request**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | funding.gateway\_log.response.data.jit\_funding.**amount**

decimal

Returned | Requested amount of funding.

**Allowable Values:**

0 min

**Format:**
0.00 | | funding.gateway\_log.response.data.jit\_funding.**balances**

object

Conditionally returned | Contains the GPA’s balance details.

**Allowable Values:**

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**

string

Conditionally returned | Holder of the business account that was funded.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**decline\_reason**

string

Conditionally returned | Reason why the transaction was declined.

**Allowable Values:**

AMOUNT\_LIMIT\_EXCEEDED, BLOCKED\_BY\_CARDHOLDER, BLOCKED\_BY\_ISSUER, BLOCKED\_MERCHANT\_BY\_CARDHOLDER, 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, SOFT\_DECLINE\_PIN\_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 strings

Conditionally returned | 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.

**Allowable Values:**

Existing incremental authorization JIT Funding tokens | | funding.gateway\_log.response.data.jit\_funding.**memo**

string

Conditionally returned | Additional information that describes the JIT Funding transaction.

**Allowable Values:**

99 char max | | funding.gateway\_log.response.data.jit\_funding.**method**

string

Returned | JIT Funding response type. See The jit\_funding object for the purpose, funding event type, and description of each method.

**Allowable Values:**

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.product.inquiry, pgfs.refund, pgfs.refund.authorization, pgfs.refund.authorization.reversal | | funding.gateway\_log.response.data.jit\_funding.**original\_jit\_funding\_token**

string

Conditionally returned | 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.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**tags**

string

Conditionally returned | Customer-defined tags related to the JIT Funding transaction.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.**token**

string

Returned | 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.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**user\_token**

string

Returned | Holder of the user account that was funded.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.**flex**

object

Conditionally returned | Contains information about a Flexible Credential transaction.

**Allowable Values:**

action, eligible, eligible\_products, secondary\_credential\_identifier, selected\_product | | funding.gateway\_log.response.data.flex.**action**

string

Conditionally returned | Indicates whether the Flexible Credential transaction object is actionable (inquiry) or merely informative (advice).

**Allowable Values:**

inquiry, advice | | funding.gateway\_log.response.data.flex.**eligible**

string

Conditionally returned | Indicates whether or not the transaction is eligible for Flexible Credential transactions.

**Allowable Values:**

true, false | | funding.gateway\_log.response.data.flex.**eligible\_products**

array of strings

Conditionally returned | Specifies which of the payment instrument’s credentials is eligible for this transaction:

- A value of DEBIT indicates the primary credential.
- A value of LOAN indicates the secondary credential.

**Allowable Values:**

DEBIT, LOAN | | funding.gateway\_log.response.data.flex.**secondary\_credential\_identifier**

string

Conditionally returned | Identifies the secondary credential used in the transaction, if applicable.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.flex.**selected\_product**

string

Conditionally returned | Indicates the eligible product that was used in the transaction.

**Allowable Values:**

DEBIT, LOAN | | funding.gateway\_log.**timed\_out**

boolean

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

**Allowable Values:**

true, false | | funding.gateway\_log.**transaction\_id**

string

Returned | Customer-defined identifier for the transaction.

**Allowable Values:**

255 char max | | funding.**source**

object

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

**Allowable Values:**

active, created\_time, is\_default\_account, last\_modified\_time, token, type | | funding.source.**active**

boolean

Returned | Whether the funding source is active.

**Allowable Values:**

true, false | | funding.source.**created\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source.**is\_default\_account**

boolean

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

**Allowable Values:**

true, false | | funding.source.**last\_modified\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source.**token**

string

Returned | Unique identifier of the funding source.

**Allowable Values:**

Format: UUID | | funding.source.**type**

string

Returned | Funding type of the funding source.

**Allowable Values:**

ach, paymentcard | | funding.**source\_address**

object

Conditionally returned | Contains information about the billing address of the funding source.

**Allowable Values:**

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**

boolean

Conditionally returned | Whether the address is active.

**Allowable Values:**

true, false | | funding.source\_address.**address\_1**

string

Returned | Street address of the funding source.

**Allowable Values:**

255 char max | | funding.source\_address.**address\_2**

string

Conditionally returned | Additional address information for the funding source.

This field is returned if it exists in the resource.

**Allowable Values:**

255 char max | | funding.source\_address.**business\_token**

string

Conditionally returned | Unique identifier of the business account holder associated with the address.

This field is returned if it exists in the resource.

**Allowable Values:**

1–36 chars | | funding.source\_address.**city**

string

Returned | City of the funding source.

**Allowable Values:**

40 char max | | funding.source\_address.**country**

string

Returned | Country of the funding source.

**Allowable Values:**

1–40 chars | | funding.source\_address.**created\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source\_address.**first\_name**

string

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

**Allowable Values:**

40 char max | | funding.source\_address.**is\_default\_address**

boolean

Conditionally returned | Whether this address is the default address used by the funding source.

**Allowable Values:**

true, false | | funding.source\_address.**last\_modified\_time**

datetime

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

This field is returned if it exists in the resource.

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source\_address.**last\_name**

string

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

**Allowable Values:**

40 char max | | funding.source\_address.**phone**

string

Conditionally returned | Phone number of the funding source.

This field is returned if it exists in the resource.

**Allowable Values:**

255 char max | | funding.source\_address.**postal\_code**

string

Returned | Postal code of the funding source.

**Allowable Values:**

10 char max | | funding.source\_address.**state**

string

Returned | Two-character state, provincial, or territorial abbreviation.

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

**Allowable Values:**

2 char max | | funding.source\_address.**token**

string

Returned | Unique identifier of the funding\_source\_address object.

**Allowable Values:**

1–36 chars | | funding.source\_address.**user\_token**

string

Conditionally returned | Unique identifier of the user account holder associated with the address.

This field is returned if it exists in the resource.

**Allowable Values:**

1–36 chars | | funding.source\_address.**zip**

string

Returned | United States ZIP code of the funding source.

**Allowable Values:**

10 char max | | funding\_source\_address\_token

string

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

**Allowable Values:**

Existing funding\_source\_address token | | funding\_source\_token

string

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

**Allowable Values:**

Existing funding\_source token | | gateway\_message

string

Conditionally returned | 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.

**Allowable Values:**

Approved or completed successfully, Declined by gateway, Operation timeout | | gateway\_token

integer

Conditionally returned | Unique identifier of the JIT Funding request and response.

This field is returned if it exists in the resource.

**Allowable Values:**

Existing gateway\_token | | jit\_funding

object

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

This object is returned if your program uses JIT Funding.

**Allowable Values:**

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**

string

Conditionally returned | User who conducted the transaction.

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

**Allowable Values:**

36 char max | | jit\_funding.**address\_verification**

object

Conditionally returned | Contains address verification data used to make JIT Funding decisions.

**Allowable Values:**

gateway, issuer, request | | jit\_funding.address\_verification.**gateway**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | jit\_funding.address\_verification.gateway.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | jit\_funding.address\_verification.gateway.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.gateway.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | jit\_funding.address\_verification.gateway.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.gateway.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | jit\_funding.address\_verification.gateway.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.gateway.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | jit\_funding.address\_verification.gateway.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.**issuer**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | jit\_funding.address\_verification.issuer.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | jit\_funding.address\_verification.issuer.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.issuer.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | jit\_funding.address\_verification.issuer.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.issuer.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | jit\_funding.address\_verification.issuer.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.issuer.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | jit\_funding.address\_verification.issuer.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.**request**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | jit\_funding.address\_verification.request.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.request.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | jit\_funding.address\_verification.request.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | jit\_funding.**jit\_account\_name\_verification**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions from one of the following objects:

- The gateway object, which contains account name verification data from your JIT Funding gateway.
- The issuer object, which contains account name verification data from the Marqeta platform.
- The request object, which contains account name verification data as it appears in a JIT Funding request.

**Allowable Values:**

gateway, issuer, request | | jit\_funding.jit\_account\_name\_verification.**gateway**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | jit\_funding.jit\_account\_name\_verification.**issuer**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | jit\_funding.jit\_account\_name\_verification.**request**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | jit\_funding.**amount**

decimal

Returned | Requested amount of funding.

**Allowable Values:**

0 min

**Format:**
0.00 | | jit\_funding.**balances**

object

Conditionally returned | Contains the GPA’s balance details.

**Allowable Values:**

available\_balance, balances, cached\_balance, credit\_balance, currency\_code, impacted\_amount, last\_updated\_time, ledger\_balance, pending\_credits | | jit\_funding.**business\_token**

string

Conditionally returned | Holder of the business account that was funded.

**Allowable Values:**

36 char max | | jit\_funding.**decline\_reason**

string

Conditionally returned | Reason why the transaction was declined.

**Allowable Values:**

AMOUNT\_LIMIT\_EXCEEDED, BLOCKED\_BY\_CARDHOLDER, BLOCKED\_BY\_ISSUER, BLOCKED\_MERCHANT\_BY\_CARDHOLDER, 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, SOFT\_DECLINE\_PIN\_REQUIRED, STOP\_PAYMENT, SUSPECTED\_FRAUD, TRANSACTION\_COUNT\_LIMIT\_EXCEEDED, TRANSACTION\_NOT\_PERMITTED | | jit\_funding.**incremental\_authorization\_jit\_funding\_tokens**

array of strings

Conditionally returned | 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.

**Allowable Values:**

Existing incremental authorization JIT Funding tokens | | jit\_funding.**memo**

string

Conditionally returned | Additional information that describes the JIT Funding transaction.

**Allowable Values:**

99 char max | | jit\_funding.**method**

string

Returned | JIT Funding response type. See The jit\_funding object for the purpose, funding event type, and description of each method.

**Allowable Values:**

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.product.inquiry, pgfs.refund, pgfs.refund.authorization, pgfs.refund.authorization.reversal | | jit\_funding.**original\_jit\_funding\_token**

string

Conditionally returned | 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.

**Allowable Values:**

36 char max | | jit\_funding.**tags**

string

Conditionally returned | Customer-defined tags related to the JIT Funding transaction.

**Allowable Values:**

255 char max | | jit\_funding.**token**

string

Returned | 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.

**Allowable Values:**

36 char max | | jit\_funding.**user\_token**

string

Returned | Holder of the user account that was funded.

**Allowable Values:**

36 char max | | last\_modified\_time

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | memo

string

Conditionally returned | Additional descriptive text.

This field is returned if it exists in the resource.

**Allowable Values:**

99 char max | | response

object

Returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | state

string

Returned | Current status of the funding transaction.

**Allowable Values:**

PENDING, CLEARED, COMPLETION, DECLINED, ERROR, REVERSED | | tags

string

Conditionally returned | Comma-delimited list of tags describing the GPA order.

This field is returned if it exists in the resource.

**Allowable Values:**

255 char max | | token

string

Returned | Unique identifier of the GPA order.

**Allowable Values:**

36 char max | | transaction\_token

string

Returned | Unique identifier of the transaction being funded.

**Allowable Values:**

Format: UUID | | user\_token

string

Conditionally returned | Unique identifier of the user resource.

This field is returned if it exists in the resource.

**Allowable Values:**

Existing user resource token |

Sample response body

```json JSON expandable lines wrap theme={null} { "token": "my_gpaorder_01", "amount": 1000, "created_time": "2025-05-10T23:00:15Z", "last_modified_time": "2025-05-10T23:00:15Z", "transaction_token": 156, "state": "COMPLETION", "response": { "code": "0000", "memo": "Approved or completed successfully" }, "funding": { "amount": 1000, "source": { "type": "program", "token": "**********e_01", "active": true, "name": "my_program_funding_source_01", "is_default_account": false, "created_time": "2024-11-30T19:13:23Z", "last_modified_time": "2024-11-30T19:13:23Z" } }, "funding_source_token": "**********e_01", "user_token": "my_user_01", "source_load_type": "ach", "currency_code": "USD" } ```

Retrieve GPA order

**Action:** `GET`\ **Endpoint:** `/gpaorders/{token}` {/* */} Use this endpoint to retrieve a GPA order.

URL path parameters

| Fields | Description | | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | token

string

Required | Unique identifier of the GPA order.

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

**Allowable Values:**

Existing GPA order token |

Response body

| Fields | Description | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | amount

decimal

Returned | Amount funded.

**Allowable Values:**

decimal

**Format:**
0.00 | | business\_token

string

Conditionally returned | Unique identifier of the business.

This field is returned if it exists in the resource.

**Allowable Values:**

Existing business\_token | | created\_time

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | currency\_code

string

Returned | Three-digit ISO 4217 currency code.

**Allowable Values:**

Valid three-digit ISO 4217 currency code | | fees

array of objects

Conditionally returned | List of fees associated with the funding transaction.

This array is returned if it exists in the resource.

**Allowable Values:**

Valid array of one or more fees objects | | fees\[].**fee**

object

Returned | Contains details about the fee.

**Allowable Values:**

amount, created\_time, currency\_code, last\_modified\_time, name, tags, token | | fees\[].fee.**amount**

decimal

Returned | Amount of the fee.

**Allowable Values:**

decimal

**Format:**
0.00 | | fees\[].fee.**created\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | fees\[].fee.**currency\_code**

string

Returned | Three-digit ISO 4217 currency code.

**Allowable Values:**

Valid three-digit ISO 4217 currency code | | fees\[].fee.**last\_modified\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | fees\[].fee.**name**

string

Returned | Name of the fee.

**Allowable Values:**

50 char max | | fees\[].fee.**tags**

string

Conditionally returned | Descriptive metadata about the fee.

**Allowable Values:**

255 char max | | fees\[].fee.**token**

string

Returned | Unique identifier of the fees object.

**Allowable Values:**

Existing fees object token | | fees\[].**memo**

string

Conditionally returned | Additional text describing the fee.

**Allowable Values:**

1–255 chars | | fees\[].**overrideAmount**

decimal

Conditionally returned | Dynamic fee amount that overrides the fee.amount field value.

**Allowable Values:**

decimal

**Format:**
0.00 | | fees\[].**tags**

string

Conditionally returned | Descriptive metadata about the fee.

**Allowable Values:**

255 char max | | fees\[].**token**

string

Returned | Unique identifier of the fee.

**Allowable Values:**

1–36 chars | | fees\[].**transaction\_token**

string

Returned | Unique identifier of the fee transaction.

**Allowable Values:**

36 char max | | funding

object

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

**Allowable Values:**

amount, gateway\_log, source, source\_address | | funding.**amount**

decimal

Conditionally returned | Amount of funds loaded into the GPA.

**Allowable Values:**

decimal

**Format:**
0.00 | | funding.**gateway\_log**

object

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

**Allowable Values:**

duration, message, order\_number, response, timed\_out, transaction\_id | | funding.gateway\_log.**duration**

integer

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

**Allowable Values:**

Any integer | | funding.gateway\_log.**message**

string

Returned | 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.

**Allowable Values:**

Approved or completed successfully, Declined by gateway, Operation timeout | | funding.gateway\_log.**order\_number**

string

Returned | Customer order number, same value as transaction.token.

**Allowable Values:**

Existing transaction.token value | | funding.gateway\_log.**response**

object

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

**Allowable Values:**

code, data | | funding.gateway\_log.response.**code**

string

Returned | Code received from the gateway.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.**data**

object

Conditionally returned | Contains the gateway’s information about the JIT Funding transaction.

**Allowable Values:**

jit\_funding | | funding.gateway\_log.response.data.**jit\_funding**

object

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

This object is returned if your program uses JIT Funding.

**Allowable Values:**

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**

string

Conditionally returned | User who conducted the transaction.

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

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**address\_verification**

object

Conditionally returned | Contains address verification data used to make JIT Funding decisions.

**Allowable Values:**

gateway, issuer, request | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**gateway**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**issuer**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**request**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.**jit\_account\_name\_verification**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions from one of the following objects:

- The gateway object, which contains account name verification data from your JIT Funding gateway.
- The issuer object, which contains account name verification data from the Marqeta platform.
- The request object, which contains account name verification data as it appears in a JIT Funding request.

**Allowable Values:**

gateway, issuer, request | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**gateway**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**issuer**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**request**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | funding.gateway\_log.response.data.jit\_funding.**amount**

decimal

Returned | Requested amount of funding.

**Allowable Values:**

0 min

**Format:**
0.00 | | funding.gateway\_log.response.data.jit\_funding.**balances**

object

Conditionally returned | Contains the GPA’s balance details.

**Allowable Values:**

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**

string

Conditionally returned | Holder of the business account that was funded.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**decline\_reason**

string

Conditionally returned | Reason why the transaction was declined.

**Allowable Values:**

AMOUNT\_LIMIT\_EXCEEDED, BLOCKED\_BY\_CARDHOLDER, BLOCKED\_BY\_ISSUER, BLOCKED\_MERCHANT\_BY\_CARDHOLDER, 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, SOFT\_DECLINE\_PIN\_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 strings

Conditionally returned | 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.

**Allowable Values:**

Existing incremental authorization JIT Funding tokens | | funding.gateway\_log.response.data.jit\_funding.**memo**

string

Conditionally returned | Additional information that describes the JIT Funding transaction.

**Allowable Values:**

99 char max | | funding.gateway\_log.response.data.jit\_funding.**method**

string

Returned | JIT Funding response type. See The jit\_funding object for the purpose, funding event type, and description of each method.

**Allowable Values:**

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.product.inquiry, pgfs.refund, pgfs.refund.authorization, pgfs.refund.authorization.reversal | | funding.gateway\_log.response.data.jit\_funding.**original\_jit\_funding\_token**

string

Conditionally returned | 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.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**tags**

string

Conditionally returned | Customer-defined tags related to the JIT Funding transaction.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.**token**

string

Returned | 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.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**user\_token**

string

Returned | Holder of the user account that was funded.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.**flex**

object

Conditionally returned | Contains information about a Flexible Credential transaction.

**Allowable Values:**

action, eligible, eligible\_products, secondary\_credential\_identifier, selected\_product | | funding.gateway\_log.response.data.flex.**action**

string

Conditionally returned | Indicates whether the Flexible Credential transaction object is actionable (inquiry) or merely informative (advice).

**Allowable Values:**

inquiry, advice | | funding.gateway\_log.response.data.flex.**eligible**

string

Conditionally returned | Indicates whether or not the transaction is eligible for Flexible Credential transactions.

**Allowable Values:**

true, false | | funding.gateway\_log.response.data.flex.**eligible\_products**

array of strings

Conditionally returned | Specifies which of the payment instrument’s credentials is eligible for this transaction:

- A value of DEBIT indicates the primary credential.
- A value of LOAN indicates the secondary credential.

**Allowable Values:**

DEBIT, LOAN | | funding.gateway\_log.response.data.flex.**secondary\_credential\_identifier**

string

Conditionally returned | Identifies the secondary credential used in the transaction, if applicable.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.flex.**selected\_product**

string

Conditionally returned | Indicates the eligible product that was used in the transaction.

**Allowable Values:**

DEBIT, LOAN | | funding.gateway\_log.**timed\_out**

boolean

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

**Allowable Values:**

true, false | | funding.gateway\_log.**transaction\_id**

string

Returned | Customer-defined identifier for the transaction.

**Allowable Values:**

255 char max | | funding.**source**

object

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

**Allowable Values:**

active, created\_time, is\_default\_account, last\_modified\_time, token, type | | funding.source.**active**

boolean

Returned | Whether the funding source is active.

**Allowable Values:**

true, false | | funding.source.**created\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source.**is\_default\_account**

boolean

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

**Allowable Values:**

true, false | | funding.source.**last\_modified\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source.**token**

string

Returned | Unique identifier of the funding source.

**Allowable Values:**

Format: UUID | | funding.source.**type**

string

Returned | Funding type of the funding source.

**Allowable Values:**

ach, paymentcard | | funding.**source\_address**

object

Conditionally returned | Contains information about the billing address of the funding source.

**Allowable Values:**

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**

boolean

Conditionally returned | Whether the address is active.

**Allowable Values:**

true, false | | funding.source\_address.**address\_1**

string

Returned | Street address of the funding source.

**Allowable Values:**

255 char max | | funding.source\_address.**address\_2**

string

Conditionally returned | Additional address information for the funding source.

This field is returned if it exists in the resource.

**Allowable Values:**

255 char max | | funding.source\_address.**business\_token**

string

Conditionally returned | Unique identifier of the business account holder associated with the address.

This field is returned if it exists in the resource.

**Allowable Values:**

1–36 chars | | funding.source\_address.**city**

string

Returned | City of the funding source.

**Allowable Values:**

40 char max | | funding.source\_address.**country**

string

Returned | Country of the funding source.

**Allowable Values:**

1–40 chars | | funding.source\_address.**created\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source\_address.**first\_name**

string

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

**Allowable Values:**

40 char max | | funding.source\_address.**is\_default\_address**

boolean

Conditionally returned | Whether this address is the default address used by the funding source.

**Allowable Values:**

true, false | | funding.source\_address.**last\_modified\_time**

datetime

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

This field is returned if it exists in the resource.

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source\_address.**last\_name**

string

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

**Allowable Values:**

40 char max | | funding.source\_address.**phone**

string

Conditionally returned | Phone number of the funding source.

This field is returned if it exists in the resource.

**Allowable Values:**

255 char max | | funding.source\_address.**postal\_code**

string

Returned | Postal code of the funding source.

**Allowable Values:**

10 char max | | funding.source\_address.**state**

string

Returned | Two-character state, provincial, or territorial abbreviation.

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

**Allowable Values:**

2 char max | | funding.source\_address.**token**

string

Returned | Unique identifier of the funding\_source\_address object.

**Allowable Values:**

1–36 chars | | funding.source\_address.**user\_token**

string

Conditionally returned | Unique identifier of the user account holder associated with the address.

This field is returned if it exists in the resource.

**Allowable Values:**

1–36 chars | | funding.source\_address.**zip**

string

Returned | United States ZIP code of the funding source.

**Allowable Values:**

10 char max | | funding\_source\_address\_token

string

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

**Allowable Values:**

Existing funding\_source\_address token | | funding\_source\_token

string

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

**Allowable Values:**

Existing funding\_source token | | gateway\_message

string

Conditionally returned | 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.

**Allowable Values:**

Approved or completed successfully, Declined by gateway, Operation timeout | | gateway\_token

integer

Conditionally returned | Unique identifier of the JIT Funding request and response.

This field is returned if it exists in the resource.

**Allowable Values:**

Existing gateway\_token | | jit\_funding

object

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

This object is returned if your program uses JIT Funding.

**Allowable Values:**

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**

string

Conditionally returned | User who conducted the transaction.

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

**Allowable Values:**

36 char max | | jit\_funding.**address\_verification**

object

Conditionally returned | Contains address verification data used to make JIT Funding decisions.

**Allowable Values:**

gateway, issuer, request | | jit\_funding.address\_verification.**gateway**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | jit\_funding.address\_verification.gateway.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | jit\_funding.address\_verification.gateway.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.gateway.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | jit\_funding.address\_verification.gateway.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.gateway.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | jit\_funding.address\_verification.gateway.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.gateway.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | jit\_funding.address\_verification.gateway.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.**issuer**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | jit\_funding.address\_verification.issuer.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | jit\_funding.address\_verification.issuer.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.issuer.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | jit\_funding.address\_verification.issuer.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.issuer.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | jit\_funding.address\_verification.issuer.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.issuer.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | jit\_funding.address\_verification.issuer.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.**request**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | jit\_funding.address\_verification.request.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.request.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | jit\_funding.address\_verification.request.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | jit\_funding.**jit\_account\_name\_verification**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions from one of the following objects:

- The gateway object, which contains account name verification data from your JIT Funding gateway.
- The issuer object, which contains account name verification data from the Marqeta platform.
- The request object, which contains account name verification data as it appears in a JIT Funding request.

**Allowable Values:**

gateway, issuer, request | | jit\_funding.jit\_account\_name\_verification.**gateway**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | jit\_funding.jit\_account\_name\_verification.**issuer**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | jit\_funding.jit\_account\_name\_verification.**request**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | jit\_funding.**amount**

decimal

Returned | Requested amount of funding.

**Allowable Values:**

0 min

**Format:**
0.00 | | jit\_funding.**balances**

object

Conditionally returned | Contains the GPA’s balance details.

**Allowable Values:**

available\_balance, balances, cached\_balance, credit\_balance, currency\_code, impacted\_amount, last\_updated\_time, ledger\_balance, pending\_credits | | jit\_funding.**business\_token**

string

Conditionally returned | Holder of the business account that was funded.

**Allowable Values:**

36 char max | | jit\_funding.**decline\_reason**

string

Conditionally returned | Reason why the transaction was declined.

**Allowable Values:**

AMOUNT\_LIMIT\_EXCEEDED, BLOCKED\_BY\_CARDHOLDER, BLOCKED\_BY\_ISSUER, BLOCKED\_MERCHANT\_BY\_CARDHOLDER, 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, SOFT\_DECLINE\_PIN\_REQUIRED, STOP\_PAYMENT, SUSPECTED\_FRAUD, TRANSACTION\_COUNT\_LIMIT\_EXCEEDED, TRANSACTION\_NOT\_PERMITTED | | jit\_funding.**incremental\_authorization\_jit\_funding\_tokens**

array of strings

Conditionally returned | 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.

**Allowable Values:**

Existing incremental authorization JIT Funding tokens | | jit\_funding.**memo**

string

Conditionally returned | Additional information that describes the JIT Funding transaction.

**Allowable Values:**

99 char max | | jit\_funding.**method**

string

Returned | JIT Funding response type. See The jit\_funding object for the purpose, funding event type, and description of each method.

**Allowable Values:**

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.product.inquiry, pgfs.refund, pgfs.refund.authorization, pgfs.refund.authorization.reversal | | jit\_funding.**original\_jit\_funding\_token**

string

Conditionally returned | 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.

**Allowable Values:**

36 char max | | jit\_funding.**tags**

string

Conditionally returned | Customer-defined tags related to the JIT Funding transaction.

**Allowable Values:**

255 char max | | jit\_funding.**token**

string

Returned | 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.

**Allowable Values:**

36 char max | | jit\_funding.**user\_token**

string

Returned | Holder of the user account that was funded.

**Allowable Values:**

36 char max | | last\_modified\_time

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | memo

string

Conditionally returned | Additional descriptive text.

This field is returned if it exists in the resource.

**Allowable Values:**

99 char max | | response

object

Returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | state

string

Returned | Current status of the funding transaction.

**Allowable Values:**

PENDING, CLEARED, COMPLETION, DECLINED, ERROR, REVERSED | | tags

string

Conditionally returned | Comma-delimited list of tags describing the GPA order.

This field is returned if it exists in the resource.

**Allowable Values:**

255 char max | | token

string

Returned | Unique identifier of the GPA order.

**Allowable Values:**

36 char max | | transaction\_token

string

Returned | Unique identifier of the transaction being funded.

**Allowable Values:**

Format: UUID | | user\_token

string

Conditionally returned | Unique identifier of the user resource.

This field is returned if it exists in the resource.

**Allowable Values:**

Existing user resource token |

Sample response body

```json JSON expandable lines wrap theme={null} { "token": "my_gpaorder_01", "amount": 1000, "created_time": "2024-11-30T23:00:15Z", "last_modified_time": "2024-11-30T23:10:15Z", "transaction_token": 156, "state": "COMPLETION", "response": { "code": "0000", "memo": "Approved or completed successfully" }, "funding": { "amount": 1000, "source": { "type": "program", "token": "**********e_01", "active": true, "name": "my_program_funding_source_01", "is_default_account": false, "created_time": "2025-03-31T19:13:23Z", "last_modified_time": "2025-03-31T19:13:23Z" } }, "funding_source_token": "**********e_01", "user_token": "my_user_01", "source_load_type": "ach", "currency_code": "USD" } ```

Create GPA unload

**Action:** `POST`\ **Endpoint:** `/gpaorders/unloads` {/* */} Use this endpoint to unload a GPA order. Unloading a GPA order returns funds to the funding source. A GPA unload must be tied to an original GPA order and can be used to return the amount of the original order or a lesser amount.

Request body

| Fields | Description | | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | amount

decimal

Required | Amount of funds to return to the funding source.

**Allowable Values:**

decimal

**Format:**
0.00 | | funding\_source\_address\_token

string

Optional | Unique identifier of the funding source to use for this GPA unload order.

Send a GET request to /fundingsources/addresses/user/{token} to retrieve addresses for a specific user.

**Allowable Values:**

1–36 chars | | memo

string

Optional | Additional descriptive text about the GPA unload.

**Allowable Values:**

99 char max | | original\_order\_token

string

Required | Unique identifier of the original GPA order.

**Allowable Values:**

1–36 chars | | tags

string

Optional | Comma-delimited list of tags describing the GPA unload order.

**Allowable Values:**

255 char max | | token

string

Optional | Unique identifier of the GPA unload 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.

**Allowable Values:**

1–36 chars |

Sample request body

```json JSON lines wrap theme={null} { "token": "my_unload_01", "original_order_token": "my_gpaorder_01", "amount": 500 } ```

Response body

| Fields | Description | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | amount

decimal

Returned | Amount of funds returned to the funding source.

**Allowable Values:**

decimal

**Format:**
0.00 | | created\_time

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding

object

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

**Allowable Values:**

amount, gateway\_log, source, source\_address | | funding.**amount**

decimal

Conditionally returned | Amount of funds loaded into the GPA.

**Allowable Values:**

decimal

**Format:**
0.00 | | funding.**gateway\_log**

object

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

**Allowable Values:**

duration, message, order\_number, response, timed\_out, transaction\_id | | funding.gateway\_log.**duration**

integer

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

**Allowable Values:**

Any integer | | funding.gateway\_log.**message**

string

Returned | 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.

**Allowable Values:**

Approved or completed successfully, Declined by gateway, Operation timeout | | funding.gateway\_log.**order\_number**

string

Returned | Customer order number, same value as transaction.token.

**Allowable Values:**

Existing transaction.token value | | funding.gateway\_log.**response**

object

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

**Allowable Values:**

code, data | | funding.gateway\_log.response.**code**

string

Returned | Code received from the gateway.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.**data**

object

Conditionally returned | Contains the gateway’s information about the JIT Funding transaction.

**Allowable Values:**

jit\_funding | | funding.gateway\_log.response.data.**jit\_funding**

object

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

This object is returned if your program uses JIT Funding.

**Allowable Values:**

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**

string

Conditionally returned | User who conducted the transaction.

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

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**address\_verification**

object

Conditionally returned | Contains address verification data used to make JIT Funding decisions.

**Allowable Values:**

gateway, issuer, request | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**gateway**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**issuer**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**request**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.**jit\_account\_name\_verification**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions from one of the following objects:

- The gateway object, which contains account name verification data from your JIT Funding gateway.
- The issuer object, which contains account name verification data from the Marqeta platform.
- The request object, which contains account name verification data as it appears in a JIT Funding request.

**Allowable Values:**

gateway, issuer, request | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**gateway**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**issuer**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**request**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | funding.gateway\_log.response.data.jit\_funding.**amount**

decimal

Returned | Requested amount of funding.

**Allowable Values:**

0 min

**Format:**
0.00 | | funding.gateway\_log.response.data.jit\_funding.**balances**

object

Conditionally returned | Contains the GPA’s balance details.

**Allowable Values:**

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**

string

Conditionally returned | Holder of the business account that was funded.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**decline\_reason**

string

Conditionally returned | Reason why the transaction was declined.

**Allowable Values:**

AMOUNT\_LIMIT\_EXCEEDED, BLOCKED\_BY\_CARDHOLDER, BLOCKED\_BY\_ISSUER, BLOCKED\_MERCHANT\_BY\_CARDHOLDER, 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, SOFT\_DECLINE\_PIN\_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 strings

Conditionally returned | 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.

**Allowable Values:**

Existing incremental authorization JIT Funding tokens | | funding.gateway\_log.response.data.jit\_funding.**memo**

string

Conditionally returned | Additional information that describes the JIT Funding transaction.

**Allowable Values:**

99 char max | | funding.gateway\_log.response.data.jit\_funding.**method**

string

Returned | JIT Funding response type. See The jit\_funding object for the purpose, funding event type, and description of each method.

**Allowable Values:**

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.product.inquiry, pgfs.refund, pgfs.refund.authorization, pgfs.refund.authorization.reversal | | funding.gateway\_log.response.data.jit\_funding.**original\_jit\_funding\_token**

string

Conditionally returned | 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.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**tags**

string

Conditionally returned | Customer-defined tags related to the JIT Funding transaction.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.**token**

string

Returned | 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.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**user\_token**

string

Returned | Holder of the user account that was funded.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.**flex**

object

Conditionally returned | Contains information about a Flexible Credential transaction.

**Allowable Values:**

action, eligible, eligible\_products, secondary\_credential\_identifier, selected\_product | | funding.gateway\_log.response.data.flex.**action**

string

Conditionally returned | Indicates whether the Flexible Credential transaction object is actionable (inquiry) or merely informative (advice).

**Allowable Values:**

inquiry, advice | | funding.gateway\_log.response.data.flex.**eligible**

string

Conditionally returned | Indicates whether or not the transaction is eligible for Flexible Credential transactions.

**Allowable Values:**

true, false | | funding.gateway\_log.response.data.flex.**eligible\_products**

array of strings

Conditionally returned | Specifies which of the payment instrument’s credentials is eligible for this transaction:

- A value of DEBIT indicates the primary credential.
- A value of LOAN indicates the secondary credential.

**Allowable Values:**

DEBIT, LOAN | | funding.gateway\_log.response.data.flex.**secondary\_credential\_identifier**

string

Conditionally returned | Identifies the secondary credential used in the transaction, if applicable.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.flex.**selected\_product**

string

Conditionally returned | Indicates the eligible product that was used in the transaction.

**Allowable Values:**

DEBIT, LOAN | | funding.gateway\_log.**timed\_out**

boolean

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

**Allowable Values:**

true, false | | funding.gateway\_log.**transaction\_id**

string

Returned | Customer-defined identifier for the transaction.

**Allowable Values:**

255 char max | | funding.**source**

object

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

**Allowable Values:**

active, created\_time, is\_default\_account, last\_modified\_time, token, type | | funding.source.**active**

boolean

Returned | Whether the funding source is active.

**Allowable Values:**

true, false | | funding.source.**created\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source.**is\_default\_account**

boolean

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

**Allowable Values:**

true, false | | funding.source.**last\_modified\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source.**token**

string

Returned | Unique identifier of the funding source.

**Allowable Values:**

Format: UUID | | funding.source.**type**

string

Returned | Funding type of the funding source.

**Allowable Values:**

ach, paymentcard | | funding.**source\_address**

object

Conditionally returned | Contains information about the billing address of the funding source.

**Allowable Values:**

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**

boolean

Conditionally returned | Whether the address is active.

**Allowable Values:**

true, false | | funding.source\_address.**address\_1**

string

Returned | Street address of the funding source.

**Allowable Values:**

255 char max | | funding.source\_address.**address\_2**

string

Conditionally returned | Additional address information for the funding source.

This field is returned if it exists in the resource.

**Allowable Values:**

255 char max | | funding.source\_address.**business\_token**

string

Conditionally returned | Unique identifier of the business account holder associated with the address.

This field is returned if it exists in the resource.

**Allowable Values:**

1–36 chars | | funding.source\_address.**city**

string

Returned | City of the funding source.

**Allowable Values:**

40 char max | | funding.source\_address.**country**

string

Returned | Country of the funding source.

**Allowable Values:**

1–40 chars | | funding.source\_address.**created\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source\_address.**first\_name**

string

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

**Allowable Values:**

40 char max | | funding.source\_address.**is\_default\_address**

boolean

Conditionally returned | Whether this address is the default address used by the funding source.

**Allowable Values:**

true, false | | funding.source\_address.**last\_modified\_time**

datetime

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

This field is returned if it exists in the resource.

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source\_address.**last\_name**

string

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

**Allowable Values:**

40 char max | | funding.source\_address.**phone**

string

Conditionally returned | Phone number of the funding source.

This field is returned if it exists in the resource.

**Allowable Values:**

255 char max | | funding.source\_address.**postal\_code**

string

Returned | Postal code of the funding source.

**Allowable Values:**

10 char max | | funding.source\_address.**state**

string

Returned | Two-character state, provincial, or territorial abbreviation.

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

**Allowable Values:**

2 char max | | funding.source\_address.**token**

string

Returned | Unique identifier of the funding\_source\_address object.

**Allowable Values:**

1–36 chars | | funding.source\_address.**user\_token**

string

Conditionally returned | Unique identifier of the user account holder associated with the address.

This field is returned if it exists in the resource.

**Allowable Values:**

1–36 chars | | funding.source\_address.**zip**

string

Returned | United States ZIP code of the funding source.

**Allowable Values:**

10 char max | | funding\_source\_address\_token

string

Conditionally returned | Identifies the funding source used for this order.

**Allowable Values:**

Existing funding\_source\_address token. | | funding\_source\_token

string

Returned | Identifies the funding source used for this order.

**Allowable Values:**

Existing funding\_source token | | jit\_funding

object

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

This object is returned if your program uses JIT Funding.

**Allowable Values:**

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**

string

Conditionally returned | User who conducted the transaction.

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

**Allowable Values:**

36 char max | | jit\_funding.**address\_verification**

object

Conditionally returned | Contains address verification data used to make JIT Funding decisions.

**Allowable Values:**

gateway, issuer, request | | jit\_funding.address\_verification.**gateway**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | jit\_funding.address\_verification.gateway.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | jit\_funding.address\_verification.gateway.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.gateway.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | jit\_funding.address\_verification.gateway.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.gateway.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | jit\_funding.address\_verification.gateway.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.gateway.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | jit\_funding.address\_verification.gateway.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.**issuer**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | jit\_funding.address\_verification.issuer.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | jit\_funding.address\_verification.issuer.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.issuer.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | jit\_funding.address\_verification.issuer.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.issuer.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | jit\_funding.address\_verification.issuer.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.issuer.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | jit\_funding.address\_verification.issuer.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.**request**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | jit\_funding.address\_verification.request.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.request.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | jit\_funding.address\_verification.request.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | jit\_funding.**jit\_account\_name\_verification**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions from one of the following objects:

- The gateway object, which contains account name verification data from your JIT Funding gateway.
- The issuer object, which contains account name verification data from the Marqeta platform.
- The request object, which contains account name verification data as it appears in a JIT Funding request.

**Allowable Values:**

gateway, issuer, request | | jit\_funding.jit\_account\_name\_verification.**gateway**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | jit\_funding.jit\_account\_name\_verification.**issuer**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | jit\_funding.jit\_account\_name\_verification.**request**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | jit\_funding.**amount**

decimal

Returned | Requested amount of funding.

**Allowable Values:**

0 min

**Format:**
0.00 | | jit\_funding.**balances**

object

Conditionally returned | Contains the GPA’s balance details.

**Allowable Values:**

available\_balance, balances, cached\_balance, credit\_balance, currency\_code, impacted\_amount, last\_updated\_time, ledger\_balance, pending\_credits | | jit\_funding.**business\_token**

string

Conditionally returned | Holder of the business account that was funded.

**Allowable Values:**

36 char max | | jit\_funding.**decline\_reason**

string

Conditionally returned | Reason why the transaction was declined.

**Allowable Values:**

AMOUNT\_LIMIT\_EXCEEDED, BLOCKED\_BY\_CARDHOLDER, BLOCKED\_BY\_ISSUER, BLOCKED\_MERCHANT\_BY\_CARDHOLDER, 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, SOFT\_DECLINE\_PIN\_REQUIRED, STOP\_PAYMENT, SUSPECTED\_FRAUD, TRANSACTION\_COUNT\_LIMIT\_EXCEEDED, TRANSACTION\_NOT\_PERMITTED | | jit\_funding.**incremental\_authorization\_jit\_funding\_tokens**

array of strings

Conditionally returned | 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.

**Allowable Values:**

Existing incremental authorization JIT Funding tokens | | jit\_funding.**memo**

string

Conditionally returned | Additional information that describes the JIT Funding transaction.

**Allowable Values:**

99 char max | | jit\_funding.**method**

string

Returned | JIT Funding response type. See The jit\_funding object for the purpose, funding event type, and description of each method.

**Allowable Values:**

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.product.inquiry, pgfs.refund, pgfs.refund.authorization, pgfs.refund.authorization.reversal | | jit\_funding.**original\_jit\_funding\_token**

string

Conditionally returned | 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.

**Allowable Values:**

36 char max | | jit\_funding.**tags**

string

Conditionally returned | Customer-defined tags related to the JIT Funding transaction.

**Allowable Values:**

255 char max | | jit\_funding.**token**

string

Returned | 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.

**Allowable Values:**

36 char max | | jit\_funding.**user\_token**

string

Returned | Holder of the user account that was funded.

**Allowable Values:**

36 char max | | last\_modified\_time

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | memo

string

Conditionally returned | Additional descriptive text.

**Allowable Values:**

99 char max | | original\_order\_token

string

Conditionally returned | Identifies the original GPA order.

**Allowable Values:**

Existing GPA order token | | response

object

Returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | state

string

Returned | Current status of the GPA unload order.

**Allowable Values:**

PENDING, CLEARED, COMPLETION, DECLINED, ERROR, REVERSED | | tags

string

Conditionally returned | Comma-delimited list of tags describing the GPA order.

**Allowable Values:**

255 char max | | token

string

Returned | Unique identifier of the GPA unload order.

**Allowable Values:**

Existing GPA unload order token | | transaction\_token

string

Returned | Unique identifier of the transaction.

**Allowable Values:**

Format: UUID |

Sample response body

```json JSON expandable lines wrap theme={null} { "token": "my_unload_01", "amount": 500, "created_time": "2024-11-30T23:14:50Z", "last_modified_time": "2024-11-30T23:30:50Z", "transaction_token": "158", "state": "COMPLETION", "response": { "code": "0000", "memo": "Approved or completed successfully" }, "funding": { "amount": 500, "source": { "type": "program", "token": "**********e_01", "active": true, "name": "my_program_funding_source_01", "is_default_account": false, "created_time": "2025-03-31T19:13:23Z", "last_modified_time": "2025-03-31T19:13:23Z" } }, "funding_source_token": "**********e_01", "original_order_token": "my_gpaorder_01" } ```

List GPA unloads

**Action:** `GET`\ **Endpoint:** `/gpaorders/unloads` {/* */} Use this endpoint to list all GPA unloads or GPA unloads associated with a specific user or business. This endpoint supports [field filtering](/core-api/field-filtering/) and [pagination](/core-api/sorting-and-pagination/).

URL query parameters

| Fields | Description | | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | count

integer

Optional | Number of resources to retrieve.

**Allowable Values:**

1-10

**Default value:**
5 | | start\_index

integer

Optional | Sort order index of the first resource in the returned array.

**Allowable Values:**

Any integer

**Default value:**
0 | | fields

string

Optional | Comma-delimited list of fields to return (field\_1,field\_2, and so on). Leave blank to return all fields.

**Allowable Values:**

Comma-delimited list of fields, or blank | | sort\_by

string

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

**Allowable Values:**

createdTime, lastModifiedTime, or any field in the resource model

**Default value:**
-lastModifiedTime | | user\_token

string

Optional | Unique identifier of the user resource.

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

**Allowable Values:**

Existing user resource token | | business\_token

string

Optional | Unique identifier of the business resource.

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

**Allowable Values:**

Existing business resource token | | original\_order\_token

string

Optional | Unique identifier of the original GPA order.

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

**Allowable Values:**

Existing GPA order token |

Response body

| Fields | Description | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | count

integer

Conditionally returned | Number of resources to retrieve.

This field is returned if there are resources in your returned array.

**Allowable Values:**

1-10 | | data

array of objects

Conditionally returned | Array of GPA unload order objects.

Objects are returned as appropriate to your query.

**Allowable Values:**

Valid array of one or more GPA unload order objects | | data\[].**amount**

decimal

Returned | Amount of funds returned to the funding source.

**Allowable Values:**

decimal

**Format:**
0.00 | | data\[].**created\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | data\[].**funding**

object

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

**Allowable Values:**

amount, gateway\_log, source, source\_address | | data\[].funding.**amount**

decimal

Conditionally returned | Amount of funds loaded into the GPA.

**Allowable Values:**

decimal

**Format:**
0.00 | | data\[].funding.**gateway\_log**

object

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

**Allowable Values:**

duration, message, order\_number, response, timed\_out, transaction\_id | | data\[].funding.gateway\_log.**duration**

integer

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

**Allowable Values:**

Any integer | | data\[].funding.gateway\_log.**message**

string

Returned | 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.

**Allowable Values:**

Approved or completed successfully, Declined by gateway, Operation timeout | | data\[].funding.gateway\_log.**order\_number**

string

Returned | Customer order number, same value as transaction.token.

**Allowable Values:**

Existing transaction.token value | | data\[].funding.gateway\_log.**response**

object

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

**Allowable Values:**

code, data | | data\[].funding.gateway\_log.response.**code**

string

Returned | Code received from the gateway.

**Allowable Values:**

255 char max | | data\[].funding.gateway\_log.response.**data**

object

Conditionally returned | Contains the gateway’s information about the JIT Funding transaction.

**Allowable Values:**

jit\_funding | | data\[].funding.gateway\_log.response.data.**jit\_funding**

object

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

This object is returned if your program uses JIT Funding.

**Allowable Values:**

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 | | data\[].funding.gateway\_log.response.data.jit\_funding.**acting\_user\_token**

string

Conditionally returned | User who conducted the transaction.

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

**Allowable Values:**

36 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.**address\_verification**

object

Conditionally returned | Contains address verification data used to make JIT Funding decisions.

**Allowable Values:**

gateway, issuer, request | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.**gateway**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.**issuer**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.**request**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.**jit\_account\_name\_verification**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions from one of the following objects:

- The gateway object, which contains account name verification data from your JIT Funding gateway.
- The issuer object, which contains account name verification data from the Marqeta platform.
- The request object, which contains account name verification data as it appears in a JIT Funding request.

**Allowable Values:**

gateway, issuer, request | | data\[].funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**gateway**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | data\[].funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**issuer**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | data\[].funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**request**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | data\[].funding.gateway\_log.response.data.jit\_funding.**amount**

decimal

Returned | Requested amount of funding.

**Allowable Values:**

0 min

**Format:**
0.00 | | data\[].funding.gateway\_log.response.data.jit\_funding.**balances**

object

Conditionally returned | Contains the GPA’s balance details.

**Allowable Values:**

available\_balance, balances, cached\_balance, credit\_balance, currency\_code, impacted\_amount, last\_updated\_time, ledger\_balance, pending\_credits | | data\[].funding.gateway\_log.response.data.jit\_funding.**business\_token**

string

Conditionally returned | Holder of the business account that was funded.

**Allowable Values:**

36 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.**decline\_reason**

string

Conditionally returned | Reason why the transaction was declined.

**Allowable Values:**

AMOUNT\_LIMIT\_EXCEEDED, BLOCKED\_BY\_CARDHOLDER, BLOCKED\_BY\_ISSUER, BLOCKED\_MERCHANT\_BY\_CARDHOLDER, 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, SOFT\_DECLINE\_PIN\_REQUIRED, STOP\_PAYMENT, SUSPECTED\_FRAUD, TRANSACTION\_COUNT\_LIMIT\_EXCEEDED, TRANSACTION\_NOT\_PERMITTED | | data\[].funding.gateway\_log.response.data.jit\_funding.**incremental\_authorization\_jit\_funding\_tokens**

array of strings

Conditionally returned | 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.

**Allowable Values:**

Existing incremental authorization JIT Funding tokens | | data\[].funding.gateway\_log.response.data.jit\_funding.**memo**

string

Conditionally returned | Additional information that describes the JIT Funding transaction.

**Allowable Values:**

99 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.**method**

string

Returned | JIT Funding response type. See The jit\_funding object for the purpose, funding event type, and description of each method.

**Allowable Values:**

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.product.inquiry, pgfs.refund, pgfs.refund.authorization, pgfs.refund.authorization.reversal | | data\[].funding.gateway\_log.response.data.jit\_funding.**original\_jit\_funding\_token**

string

Conditionally returned | 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.

**Allowable Values:**

36 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.**tags**

string

Conditionally returned | Customer-defined tags related to the JIT Funding transaction.

**Allowable Values:**

255 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.**token**

string

Returned | 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.

**Allowable Values:**

36 char max | | data\[].funding.gateway\_log.response.data.jit\_funding.**user\_token**

string

Returned | Holder of the user account that was funded.

**Allowable Values:**

36 char max | | data\[].funding.gateway\_log.response.data.**flex**

object

Conditionally returned | Contains information about a Flexible Credential transaction.

**Allowable Values:**

action, eligible, eligible\_products, secondary\_credential\_identifier, selected\_product | | data\[].funding.gateway\_log.response.data.flex.**action**

string

Conditionally returned | Indicates whether the Flexible Credential transaction object is actionable (inquiry) or merely informative (advice).

**Allowable Values:**

inquiry, advice | | data\[].funding.gateway\_log.response.data.flex.**eligible**

string

Conditionally returned | Indicates whether or not the transaction is eligible for Flexible Credential transactions.

**Allowable Values:**

true, false | | data\[].funding.gateway\_log.response.data.flex.**eligible\_products**

array of strings

Conditionally returned | Specifies which of the payment instrument’s credentials is eligible for this transaction:

- A value of DEBIT indicates the primary credential.
- A value of LOAN indicates the secondary credential.

**Allowable Values:**

DEBIT, LOAN | | data\[].funding.gateway\_log.response.data.flex.**secondary\_credential\_identifier**

string

Conditionally returned | Identifies the secondary credential used in the transaction, if applicable.

**Allowable Values:**

255 char max | | data\[].funding.gateway\_log.response.data.flex.**selected\_product**

string

Conditionally returned | Indicates the eligible product that was used in the transaction.

**Allowable Values:**

DEBIT, LOAN | | data\[].funding.gateway\_log.**timed\_out**

boolean

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

**Allowable Values:**

true, false | | data\[].funding.gateway\_log.**transaction\_id**

string

Returned | Customer-defined identifier for the transaction.

**Allowable Values:**

255 char max | | data\[].funding.**source**

object

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

**Allowable Values:**

active, created\_time, is\_default\_account, last\_modified\_time, token, type | | data\[].funding.source.**active**

boolean

Returned | Whether the funding source is active.

**Allowable Values:**

true, false | | data\[].funding.source.**created\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | data\[].funding.source.**is\_default\_account**

boolean

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

**Allowable Values:**

true, false | | data\[].funding.source.**last\_modified\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | data\[].funding.source.**token**

string

Returned | Unique identifier of the funding source.

**Allowable Values:**

Format: UUID | | data\[].funding.source.**type**

string

Returned | Funding type of the funding source.

**Allowable Values:**

ach, paymentcard | | data\[].funding.**source\_address**

object

Conditionally returned | Contains information about the billing address of the funding source.

**Allowable Values:**

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 | | data\[].funding.source\_address.**active**

boolean

Conditionally returned | Whether the address is active.

**Allowable Values:**

true, false | | data\[].funding.source\_address.**address\_1**

string

Returned | Street address of the funding source.

**Allowable Values:**

255 char max | | data\[].funding.source\_address.**address\_2**

string

Conditionally returned | Additional address information for the funding source.

This field is returned if it exists in the resource.

**Allowable Values:**

255 char max | | data\[].funding.source\_address.**business\_token**

string

Conditionally returned | Unique identifier of the business account holder associated with the address.

This field is returned if it exists in the resource.

**Allowable Values:**

1–36 chars | | data\[].funding.source\_address.**city**

string

Returned | City of the funding source.

**Allowable Values:**

40 char max | | data\[].funding.source\_address.**country**

string

Returned | Country of the funding source.

**Allowable Values:**

1–40 chars | | data\[].funding.source\_address.**created\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | data\[].funding.source\_address.**first\_name**

string

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

**Allowable Values:**

40 char max | | data\[].funding.source\_address.**is\_default\_address**

boolean

Conditionally returned | Whether this address is the default address used by the funding source.

**Allowable Values:**

true, false | | data\[].funding.source\_address.**last\_modified\_time**

datetime

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

This field is returned if it exists in the resource.

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | data\[].funding.source\_address.**last\_name**

string

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

**Allowable Values:**

40 char max | | data\[].funding.source\_address.**phone**

string

Conditionally returned | Phone number of the funding source.

This field is returned if it exists in the resource.

**Allowable Values:**

255 char max | | data\[].funding.source\_address.**postal\_code**

string

Returned | Postal code of the funding source.

**Allowable Values:**

10 char max | | data\[].funding.source\_address.**state**

string

Returned | Two-character state, provincial, or territorial abbreviation.

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

**Allowable Values:**

2 char max | | data\[].funding.source\_address.**token**

string

Returned | Unique identifier of the funding\_source\_address object.

**Allowable Values:**

1–36 chars | | data\[].funding.source\_address.**user\_token**

string

Conditionally returned | Unique identifier of the user account holder associated with the address.

This field is returned if it exists in the resource.

**Allowable Values:**

1–36 chars | | data\[].funding.source\_address.**zip**

string

Returned | United States ZIP code of the funding source.

**Allowable Values:**

10 char max | | data\[].**funding\_source\_address\_token**

string

Conditionally returned | Identifies the funding source used for this order.

**Allowable Values:**

Existing funding\_source\_address token. | | data\[].**funding\_source\_token**

string

Returned | Identifies the funding source used for this order.

**Allowable Values:**

Existing funding\_source token | | data\[].**jit\_funding**

object

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

This object is returned if your program uses JIT Funding.

**Allowable Values:**

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 | | data\[].jit\_funding.**acting\_user\_token**

string

Conditionally returned | User who conducted the transaction.

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

**Allowable Values:**

36 char max | | data\[].jit\_funding.**address\_verification**

object

Conditionally returned | Contains address verification data used to make JIT Funding decisions.

**Allowable Values:**

gateway, issuer, request | | data\[].jit\_funding.address\_verification.**gateway**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | data\[].jit\_funding.address\_verification.gateway.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | data\[].jit\_funding.address\_verification.gateway.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | data\[].jit\_funding.address\_verification.gateway.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | data\[].jit\_funding.address\_verification.gateway.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | data\[].jit\_funding.address\_verification.gateway.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | data\[].jit\_funding.address\_verification.gateway.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | data\[].jit\_funding.address\_verification.gateway.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | data\[].jit\_funding.address\_verification.gateway.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | data\[].jit\_funding.address\_verification.**issuer**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | data\[].jit\_funding.address\_verification.issuer.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | data\[].jit\_funding.address\_verification.issuer.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | data\[].jit\_funding.address\_verification.issuer.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | data\[].jit\_funding.address\_verification.issuer.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | data\[].jit\_funding.address\_verification.issuer.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | data\[].jit\_funding.address\_verification.issuer.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | data\[].jit\_funding.address\_verification.issuer.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | data\[].jit\_funding.address\_verification.issuer.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | data\[].jit\_funding.address\_verification.**request**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | data\[].jit\_funding.address\_verification.request.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | data\[].jit\_funding.address\_verification.request.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | data\[].jit\_funding.address\_verification.request.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | data\[].jit\_funding.**jit\_account\_name\_verification**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions from one of the following objects:

- The gateway object, which contains account name verification data from your JIT Funding gateway.
- The issuer object, which contains account name verification data from the Marqeta platform.
- The request object, which contains account name verification data as it appears in a JIT Funding request.

**Allowable Values:**

gateway, issuer, request | | data\[].jit\_funding.jit\_account\_name\_verification.**gateway**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | data\[].jit\_funding.jit\_account\_name\_verification.**issuer**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | data\[].jit\_funding.jit\_account\_name\_verification.**request**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | data\[].jit\_funding.**amount**

decimal

Returned | Requested amount of funding.

**Allowable Values:**

0 min

**Format:**
0.00 | | data\[].jit\_funding.**balances**

object

Conditionally returned | Contains the GPA’s balance details.

**Allowable Values:**

available\_balance, balances, cached\_balance, credit\_balance, currency\_code, impacted\_amount, last\_updated\_time, ledger\_balance, pending\_credits | | data\[].jit\_funding.**business\_token**

string

Conditionally returned | Holder of the business account that was funded.

**Allowable Values:**

36 char max | | data\[].jit\_funding.**decline\_reason**

string

Conditionally returned | Reason why the transaction was declined.

**Allowable Values:**

AMOUNT\_LIMIT\_EXCEEDED, BLOCKED\_BY\_CARDHOLDER, BLOCKED\_BY\_ISSUER, BLOCKED\_MERCHANT\_BY\_CARDHOLDER, 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, SOFT\_DECLINE\_PIN\_REQUIRED, STOP\_PAYMENT, SUSPECTED\_FRAUD, TRANSACTION\_COUNT\_LIMIT\_EXCEEDED, TRANSACTION\_NOT\_PERMITTED | | data\[].jit\_funding.**incremental\_authorization\_jit\_funding\_tokens**

array of strings

Conditionally returned | 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.

**Allowable Values:**

Existing incremental authorization JIT Funding tokens | | data\[].jit\_funding.**memo**

string

Conditionally returned | Additional information that describes the JIT Funding transaction.

**Allowable Values:**

99 char max | | data\[].jit\_funding.**method**

string

Returned | JIT Funding response type. See The jit\_funding object for the purpose, funding event type, and description of each method.

**Allowable Values:**

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.product.inquiry, pgfs.refund, pgfs.refund.authorization, pgfs.refund.authorization.reversal | | data\[].jit\_funding.**original\_jit\_funding\_token**

string

Conditionally returned | 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.

**Allowable Values:**

36 char max | | data\[].jit\_funding.**tags**

string

Conditionally returned | Customer-defined tags related to the JIT Funding transaction.

**Allowable Values:**

255 char max | | data\[].jit\_funding.**token**

string

Returned | 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.

**Allowable Values:**

36 char max | | data\[].jit\_funding.**user\_token**

string

Returned | Holder of the user account that was funded.

**Allowable Values:**

36 char max | | data\[].**last\_modified\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | data\[].**memo**

string

Conditionally returned | Additional descriptive text.

**Allowable Values:**

99 char max | | data\[].**original\_order\_token**

string

Conditionally returned | Identifies the original GPA order.

**Allowable Values:**

Existing GPA order token | | data\[].**response**

object

Returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | data\[].response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | data\[].response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | data\[].response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | data\[].**state**

string

Returned | Current status of the GPA unload order.

**Allowable Values:**

PENDING, CLEARED, COMPLETION, DECLINED, ERROR, REVERSED | | data\[].**tags**

string

Conditionally returned | Comma-delimited list of tags describing the GPA order.

**Allowable Values:**

255 char max | | data\[].**token**

string

Returned | Unique identifier of the GPA unload order.

**Allowable Values:**

Existing GPA unload order token | | data\[].**transaction\_token**

string

Returned | Unique identifier of the transaction.

**Allowable Values:**

Format: UUID | | end\_index

integer

Conditionally returned | Sort order index of the last resource in the returned array.

This field is returned if there are resources in your returned array.

**Allowable Values:**

Any integer | | is\_more

boolean

Conditionally returned | A value of true indicates that more unreturned resources exist. A value of false indicates that no more unreturned resources exist.

This field is returned if there are resources in your returned array.

**Allowable Values:**

true, false | | start\_index

integer

Conditionally returned | Sort order index of the first resource in the returned array.

This field is returned if there are resources in your returned array.

**Allowable Values:**

Any integer |

Sample response body

```json JSON expandable lines wrap theme={null} { "count": 2, "start_index": 0, "end_index": 1, "is_more": false, "data[]": { "token": "my_unload_01", "amount": 500, "created_time": "2024-11-30T23:14:50Z", "last_modified_time": "2024-11-30T23:15:50Z", "transaction_token": "158", "state": "COMPLETION", "response": { "code": "0000", "memo": "Approved or completed successfully" }, "funding": { "amount": 500, "source": { "type": "program", "token": "**********e_01", "active": true, "name": "my_program_funding_source_01", "is_default_account": false, "created_time": "2025-03-31T19:13:23Z", "last_modified_time": "2025-03-31T19:13:23Z" } }, "funding_source_token": "**********e_01", "original_order_token": "my_gpaorder_01" } } ```

Retrieve GPA unload

**Action:** `GET`\ **Endpoint:** `/gpaorders/unloads/{unload_token}` {/* */} Use this endpoint to retrieve a specific GPA unload.

URL path parameters

| Fields | Description | | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | unload\_token

string

Required | Unique identifier of the GPA unload.

**Allowable Values:**

Existing GPA unload token |

Response body

| Fields | Description | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | amount

decimal

Returned | Amount of funds returned to the funding source.

**Allowable Values:**

decimal

**Format:**
0.00 | | created\_time

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding

object

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

**Allowable Values:**

amount, gateway\_log, source, source\_address | | funding.**amount**

decimal

Conditionally returned | Amount of funds loaded into the GPA.

**Allowable Values:**

decimal

**Format:**
0.00 | | funding.**gateway\_log**

object

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

**Allowable Values:**

duration, message, order\_number, response, timed\_out, transaction\_id | | funding.gateway\_log.**duration**

integer

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

**Allowable Values:**

Any integer | | funding.gateway\_log.**message**

string

Returned | 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.

**Allowable Values:**

Approved or completed successfully, Declined by gateway, Operation timeout | | funding.gateway\_log.**order\_number**

string

Returned | Customer order number, same value as transaction.token.

**Allowable Values:**

Existing transaction.token value | | funding.gateway\_log.**response**

object

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

**Allowable Values:**

code, data | | funding.gateway\_log.response.**code**

string

Returned | Code received from the gateway.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.**data**

object

Conditionally returned | Contains the gateway’s information about the JIT Funding transaction.

**Allowable Values:**

jit\_funding | | funding.gateway\_log.response.data.**jit\_funding**

object

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

This object is returned if your program uses JIT Funding.

**Allowable Values:**

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**

string

Conditionally returned | User who conducted the transaction.

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

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**address\_verification**

object

Conditionally returned | Contains address verification data used to make JIT Funding decisions.

**Allowable Values:**

gateway, issuer, request | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**gateway**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | funding.gateway\_log.response.data.jit\_funding.address\_verification.gateway.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**issuer**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | funding.gateway\_log.response.data.jit\_funding.address\_verification.issuer.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.**request**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | funding.gateway\_log.response.data.jit\_funding.address\_verification.request.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | funding.gateway\_log.response.data.jit\_funding.**jit\_account\_name\_verification**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions from one of the following objects:

- The gateway object, which contains account name verification data from your JIT Funding gateway.
- The issuer object, which contains account name verification data from the Marqeta platform.
- The request object, which contains account name verification data as it appears in a JIT Funding request.

**Allowable Values:**

gateway, issuer, request | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**gateway**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**issuer**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | funding.gateway\_log.response.data.jit\_funding.jit\_account\_name\_verification.**request**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | funding.gateway\_log.response.data.jit\_funding.**amount**

decimal

Returned | Requested amount of funding.

**Allowable Values:**

0 min

**Format:**
0.00 | | funding.gateway\_log.response.data.jit\_funding.**balances**

object

Conditionally returned | Contains the GPA’s balance details.

**Allowable Values:**

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**

string

Conditionally returned | Holder of the business account that was funded.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**decline\_reason**

string

Conditionally returned | Reason why the transaction was declined.

**Allowable Values:**

AMOUNT\_LIMIT\_EXCEEDED, BLOCKED\_BY\_CARDHOLDER, BLOCKED\_BY\_ISSUER, BLOCKED\_MERCHANT\_BY\_CARDHOLDER, 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, SOFT\_DECLINE\_PIN\_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 strings

Conditionally returned | 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.

**Allowable Values:**

Existing incremental authorization JIT Funding tokens | | funding.gateway\_log.response.data.jit\_funding.**memo**

string

Conditionally returned | Additional information that describes the JIT Funding transaction.

**Allowable Values:**

99 char max | | funding.gateway\_log.response.data.jit\_funding.**method**

string

Returned | JIT Funding response type. See The jit\_funding object for the purpose, funding event type, and description of each method.

**Allowable Values:**

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.product.inquiry, pgfs.refund, pgfs.refund.authorization, pgfs.refund.authorization.reversal | | funding.gateway\_log.response.data.jit\_funding.**original\_jit\_funding\_token**

string

Conditionally returned | 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.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**tags**

string

Conditionally returned | Customer-defined tags related to the JIT Funding transaction.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.jit\_funding.**token**

string

Returned | 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.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.jit\_funding.**user\_token**

string

Returned | Holder of the user account that was funded.

**Allowable Values:**

36 char max | | funding.gateway\_log.response.data.**flex**

object

Conditionally returned | Contains information about a Flexible Credential transaction.

**Allowable Values:**

action, eligible, eligible\_products, secondary\_credential\_identifier, selected\_product | | funding.gateway\_log.response.data.flex.**action**

string

Conditionally returned | Indicates whether the Flexible Credential transaction object is actionable (inquiry) or merely informative (advice).

**Allowable Values:**

inquiry, advice | | funding.gateway\_log.response.data.flex.**eligible**

string

Conditionally returned | Indicates whether or not the transaction is eligible for Flexible Credential transactions.

**Allowable Values:**

true, false | | funding.gateway\_log.response.data.flex.**eligible\_products**

array of strings

Conditionally returned | Specifies which of the payment instrument’s credentials is eligible for this transaction:

- A value of DEBIT indicates the primary credential.
- A value of LOAN indicates the secondary credential.

**Allowable Values:**

DEBIT, LOAN | | funding.gateway\_log.response.data.flex.**secondary\_credential\_identifier**

string

Conditionally returned | Identifies the secondary credential used in the transaction, if applicable.

**Allowable Values:**

255 char max | | funding.gateway\_log.response.data.flex.**selected\_product**

string

Conditionally returned | Indicates the eligible product that was used in the transaction.

**Allowable Values:**

DEBIT, LOAN | | funding.gateway\_log.**timed\_out**

boolean

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

**Allowable Values:**

true, false | | funding.gateway\_log.**transaction\_id**

string

Returned | Customer-defined identifier for the transaction.

**Allowable Values:**

255 char max | | funding.**source**

object

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

**Allowable Values:**

active, created\_time, is\_default\_account, last\_modified\_time, token, type | | funding.source.**active**

boolean

Returned | Whether the funding source is active.

**Allowable Values:**

true, false | | funding.source.**created\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source.**is\_default\_account**

boolean

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

**Allowable Values:**

true, false | | funding.source.**last\_modified\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source.**token**

string

Returned | Unique identifier of the funding source.

**Allowable Values:**

Format: UUID | | funding.source.**type**

string

Returned | Funding type of the funding source.

**Allowable Values:**

ach, paymentcard | | funding.**source\_address**

object

Conditionally returned | Contains information about the billing address of the funding source.

**Allowable Values:**

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**

boolean

Conditionally returned | Whether the address is active.

**Allowable Values:**

true, false | | funding.source\_address.**address\_1**

string

Returned | Street address of the funding source.

**Allowable Values:**

255 char max | | funding.source\_address.**address\_2**

string

Conditionally returned | Additional address information for the funding source.

This field is returned if it exists in the resource.

**Allowable Values:**

255 char max | | funding.source\_address.**business\_token**

string

Conditionally returned | Unique identifier of the business account holder associated with the address.

This field is returned if it exists in the resource.

**Allowable Values:**

1–36 chars | | funding.source\_address.**city**

string

Returned | City of the funding source.

**Allowable Values:**

40 char max | | funding.source\_address.**country**

string

Returned | Country of the funding source.

**Allowable Values:**

1–40 chars | | funding.source\_address.**created\_time**

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source\_address.**first\_name**

string

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

**Allowable Values:**

40 char max | | funding.source\_address.**is\_default\_address**

boolean

Conditionally returned | Whether this address is the default address used by the funding source.

**Allowable Values:**

true, false | | funding.source\_address.**last\_modified\_time**

datetime

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

This field is returned if it exists in the resource.

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | funding.source\_address.**last\_name**

string

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

**Allowable Values:**

40 char max | | funding.source\_address.**phone**

string

Conditionally returned | Phone number of the funding source.

This field is returned if it exists in the resource.

**Allowable Values:**

255 char max | | funding.source\_address.**postal\_code**

string

Returned | Postal code of the funding source.

**Allowable Values:**

10 char max | | funding.source\_address.**state**

string

Returned | Two-character state, provincial, or territorial abbreviation.

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

**Allowable Values:**

2 char max | | funding.source\_address.**token**

string

Returned | Unique identifier of the funding\_source\_address object.

**Allowable Values:**

1–36 chars | | funding.source\_address.**user\_token**

string

Conditionally returned | Unique identifier of the user account holder associated with the address.

This field is returned if it exists in the resource.

**Allowable Values:**

1–36 chars | | funding.source\_address.**zip**

string

Returned | United States ZIP code of the funding source.

**Allowable Values:**

10 char max | | funding\_source\_address\_token

string

Conditionally returned | Identifies the funding source used for this order.

**Allowable Values:**

Existing funding\_source\_address token. | | funding\_source\_token

string

Returned | Identifies the funding source used for this order.

**Allowable Values:**

Existing funding\_source token | | jit\_funding

object

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

This object is returned if your program uses JIT Funding.

**Allowable Values:**

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**

string

Conditionally returned | User who conducted the transaction.

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

**Allowable Values:**

36 char max | | jit\_funding.**address\_verification**

object

Conditionally returned | Contains address verification data used to make JIT Funding decisions.

**Allowable Values:**

gateway, issuer, request | | jit\_funding.address\_verification.**gateway**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | jit\_funding.address\_verification.gateway.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | jit\_funding.address\_verification.gateway.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.gateway.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | jit\_funding.address\_verification.gateway.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.gateway.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | jit\_funding.address\_verification.gateway.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.gateway.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | jit\_funding.address\_verification.gateway.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.**issuer**

object

Conditionally returned | 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.

**Allowable Values:**

on\_file, response | | jit\_funding.address\_verification.issuer.**on\_file**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | jit\_funding.address\_verification.issuer.on\_file.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.issuer.on\_file.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | jit\_funding.address\_verification.issuer.on\_file.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.issuer.**response**

object

Conditionally returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | jit\_funding.address\_verification.issuer.response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.issuer.response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | jit\_funding.address\_verification.issuer.response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | jit\_funding.address\_verification.**request**

object

Conditionally returned | Contains address verification information.

**Allowable Values:**

postal\_code, street\_address, zip | | jit\_funding.address\_verification.request.**postal\_code**

string

Conditionally returned | Postal code of the address.

**Allowable Values:**

10 char max | | jit\_funding.address\_verification.request.**street\_address**

string

Conditionally returned | Street name and number of the address.

**Allowable Values:**

40 char max | | jit\_funding.address\_verification.request.**zip**

string

Conditionally returned | United States ZIP code of the address.

**Allowable Values:**

10 char max | | jit\_funding.**jit\_account\_name\_verification**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions from one of the following objects:

- The gateway object, which contains account name verification data from your JIT Funding gateway.
- The issuer object, which contains account name verification data from the Marqeta platform.
- The request object, which contains account name verification data as it appears in a JIT Funding request.

**Allowable Values:**

gateway, issuer, request | | jit\_funding.jit\_account\_name\_verification.**gateway**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | jit\_funding.jit\_account\_name\_verification.**issuer**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | jit\_funding.jit\_account\_name\_verification.**request**

object

Conditionally returned | Contains account name verification data used to make JIT Funding decisions.

**Allowable Values:**

first\_name, last\_name, middle\_name | | jit\_funding.**amount**

decimal

Returned | Requested amount of funding.

**Allowable Values:**

0 min

**Format:**
0.00 | | jit\_funding.**balances**

object

Conditionally returned | Contains the GPA’s balance details.

**Allowable Values:**

available\_balance, balances, cached\_balance, credit\_balance, currency\_code, impacted\_amount, last\_updated\_time, ledger\_balance, pending\_credits | | jit\_funding.**business\_token**

string

Conditionally returned | Holder of the business account that was funded.

**Allowable Values:**

36 char max | | jit\_funding.**decline\_reason**

string

Conditionally returned | Reason why the transaction was declined.

**Allowable Values:**

AMOUNT\_LIMIT\_EXCEEDED, BLOCKED\_BY\_CARDHOLDER, BLOCKED\_BY\_ISSUER, BLOCKED\_MERCHANT\_BY\_CARDHOLDER, 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, SOFT\_DECLINE\_PIN\_REQUIRED, STOP\_PAYMENT, SUSPECTED\_FRAUD, TRANSACTION\_COUNT\_LIMIT\_EXCEEDED, TRANSACTION\_NOT\_PERMITTED | | jit\_funding.**incremental\_authorization\_jit\_funding\_tokens**

array of strings

Conditionally returned | 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.

**Allowable Values:**

Existing incremental authorization JIT Funding tokens | | jit\_funding.**memo**

string

Conditionally returned | Additional information that describes the JIT Funding transaction.

**Allowable Values:**

99 char max | | jit\_funding.**method**

string

Returned | JIT Funding response type. See The jit\_funding object for the purpose, funding event type, and description of each method.

**Allowable Values:**

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.product.inquiry, pgfs.refund, pgfs.refund.authorization, pgfs.refund.authorization.reversal | | jit\_funding.**original\_jit\_funding\_token**

string

Conditionally returned | 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.

**Allowable Values:**

36 char max | | jit\_funding.**tags**

string

Conditionally returned | Customer-defined tags related to the JIT Funding transaction.

**Allowable Values:**

255 char max | | jit\_funding.**token**

string

Returned | 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.

**Allowable Values:**

36 char max | | jit\_funding.**user\_token**

string

Returned | Holder of the user account that was funded.

**Allowable Values:**

36 char max | | last\_modified\_time

datetime

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

**Allowable Values:**

datetime

**Format:**
yyyy-MM-ddThh:mm:ssZ | | memo

string

Conditionally returned | Additional descriptive text.

**Allowable Values:**

99 char max | | original\_order\_token

string

Conditionally returned | Identifies the original GPA order.

**Allowable Values:**

Existing GPA order token | | response

object

Returned | Response codes and memos for account name verification, address verification, card security verification, and transactions.

**Allowable Values:**

additional\_information, code, memo | | response.**additional\_information**

string

Conditionally returned | Additional information about the transaction, such as velocity control details.

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

**Allowable Values:**

255 char max | | response.**code**

string

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

For account name verification, the four digits correspond with assertions that the first, middle, last, and full name of the cardholder on the Marqeta platform match the data provided by the cardholder.

- 0 indicates no validation was performed
- 1 indicates the match was unsuccessful (not matched)
- 2 indicates the match was partial
- 3 indicates the match was exact

For example:

Code / First Name / Middle Name / Last Name / Full Name
0000 / Not validated / Not validated / Not validated / Not validated
1111 / Not matched / Not matched / Not matched / Not matched
3333 / Exact match / Exact match / Exact match / Exact match
1232 / Not matched / Partial match / Exact match / Partial match

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:

Code / Address / Postal Code
0000 / Match / Match
0001 / Match / Not matched
0100 / Not matched / Match
0101 / Not matched / Not matched
0200 / Data not present / Match
0201 / Data not present / Not matched
0002 / Match / Data not present
0102 / Not matched / Data not present
0303 / Not validated / Not validated

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

- 0000 – Passed
- 0001 – Did not pass

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

**Allowable Values:**

Four-digit code | | response.**memo**

string

Returned | Additional text that describes the response.

**Allowable Values:**

255 char max | | state

string

Returned | Current status of the GPA unload order.

**Allowable Values:**

PENDING, CLEARED, COMPLETION, DECLINED, ERROR, REVERSED | | tags

string

Conditionally returned | Comma-delimited list of tags describing the GPA order.

**Allowable Values:**

255 char max | | token

string

Returned | Unique identifier of the GPA unload order.

**Allowable Values:**

Existing GPA unload order token | | transaction\_token

string

Returned | Unique identifier of the transaction.

**Allowable Values:**

Format: UUID |

Sample response body

```json JSON expandable lines wrap theme={null} { "token": "my_unload_01", "amount": 500, "created_time": "2024-11-30T23:14:50Z", "last_modified_time": "2024-11-30T23:15:50Z", "transaction_token": "158", "state": "COMPLETION", "response": { "code": "0000", "memo": "Approved or completed successfully" }, "funding": { "amount": 500, "source": { "type": "program", "token": "**********e_01", "active": true, "name": "my_program_funding_source_01", "is_default_account": false, "created_time": "2025-03-31T19:13:23Z", "last_modified_time": "2025-03-31T19:13:23Z" } }, "funding_source_token": "**********e_01", "original_order_token": "my_gpaorder_01" } ``` ## Related topics - [Transactions](/docs/core-api/transactions.md) - [Simulations 2.0 — Card Transactions](/docs/core-api/simulations-card-transactions.md) - [Event Types](/docs/core-api/event-types.md) - [Gateway JIT Funding Messages](/docs/core-api/gateway-jit-funding-messages.md) - [Auto Reload](/docs/core-api/auto-reload.md)