Create GPA unload - Marqeta Docs

Home

Getting Started

Testing

Card Issuing

Card Processing

Accounts & Money Movement

Risk, Fraud, and Disputes

Cardholder User Experience

POST//

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: 0.01 min 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

{
  "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

{
  "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"
}