POST/
Use this endpoint to create an order to fund an account holder’s GPA.
You can assess a fee 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
{
"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 exactFor example: Code / First Name / Middle Name / Last Name / Full Name 0000 / Not validated / Not validated / Not validated / Not validated1111 / Not matched / Not matched / Not matched / Not matched3333 / Exact match / Exact match / Exact match / Exact match1232 / Not matched / Partial match / Exact match / Partial matchFor 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 / Match0001 / Match / Not matched0100 / Not matched / Match0101 / Not matched / Not matched0200 / Data not present / Match0201 / Data not present / Not matched0002 / Match / Data not present0102 / Not matched / Data not present0303 / Not validated / Not validatedFor card security verification, the code indicates whether the verification check passed and can have these possible values: - 0000 – Passed- 0001 – Did not passFor 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 exactFor example: Code / First Name / Middle Name / Last Name / Full Name 0000 / Not validated / Not validated / Not validated / Not validated1111 / Not matched / Not matched / Not matched / Not matched3333 / Exact match / Exact match / Exact match / Exact match1232 / Not matched / Partial match / Exact match / Partial matchFor 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 / Match0001 / Match / Not matched0100 / Not matched / Match0101 / Not matched / Not matched0200 / Data not present / Match0201 / Data not present / Not matched0002 / Match / Data not present0102 / Not matched / Data not present0303 / Not validated / Not validatedFor card security verification, the code indicates whether the verification check passed and can have these possible values: - 0000 – Passed- 0001 – Did not passFor 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 exactFor example: Code / First Name / Middle Name / Last Name / Full Name 0000 / Not validated / Not validated / Not validated / Not validated1111 / Not matched / Not matched / Not matched / Not matched3333 / Exact match / Exact match / Exact match / Exact match1232 / Not matched / Partial match / Exact match / Partial matchFor 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 / Match0001 / Match / Not matched0100 / Not matched / Match0101 / Not matched / Not matched0200 / Data not present / Match0201 / Data not present / Not matched0002 / Match / Data not present0102 / Not matched / Data not present0303 / Not validated / Not validatedFor card security verification, the code indicates whether the verification check passed and can have these possible values: - 0000 – Passed- 0001 – Did not passFor 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 exactFor example: Code / First Name / Middle Name / Last Name / Full Name 0000 / Not validated / Not validated / Not validated / Not validated1111 / Not matched / Not matched / Not matched / Not matched3333 / Exact match / Exact match / Exact match / Exact match1232 / Not matched / Partial match / Exact match / Partial matchFor 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 / Match0001 / Match / Not matched0100 / Not matched / Match0101 / Not matched / Not matched0200 / Data not present / Match0201 / Data not present / Not matched0002 / Match / Data not present0102 / Not matched / Data not present0303 / Not validated / Not validatedFor card security verification, the code indicates whether the verification check passed and can have these possible values: - 0000 – Passed- 0001 – Did not passFor 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 exactFor example: Code / First Name / Middle Name / Last Name / Full Name 0000 / Not validated / Not validated / Not validated / Not validated1111 / Not matched / Not matched / Not matched / Not matched3333 / Exact match / Exact match / Exact match / Exact match1232 / Not matched / Partial match / Exact match / Partial matchFor 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 / Match0001 / Match / Not matched0100 / Not matched / Match0101 / Not matched / Not matched0200 / Data not present / Match0201 / Data not present / Not matched0002 / Match / Data not present0102 / Not matched / Data not present0303 / Not validated / Not validatedFor card security verification, the code indicates whether the verification check passed and can have these possible values: - 0000 – Passed- 0001 – Did not passFor 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
{
"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"
}