PAYMENT group. For more on payment journal entries, see Payments in the About Credit Account Journal Entries guide.
Create account payment
Action:POSTEndpoint:
/credit/accounts/{account_token}/payments
Create a new payment to apply toward a credit account’s balance.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the credit account for which to create a payment. Send a GET request to /credit/accounts to retrieve existing credit account tokens.Allowable Values: Existing account token |
Request body
| Fields | Description |
|---|---|
| token string Optional | Unique identifier of the payment. Allowable Values: 36 char max |
| method string Required | Method of payment. Allowable Values: ACH, CHECK, DEBIT, CASH |
| payment_source_token string Optional | Unique identifier of the payment source. Required for ACH payments. Allowable Values: 36 char max Existing payment source token |
| amount decimal Required | Amount of the payment. Allowable Values: 0 min |
| currency_code string Required | Valid three-digit ISO 4217 currency code. Allowable Values: USD |
| impact_time datetime Optional | Date and time when the payment impacts the account balance and fee calculations. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| description string Required | Description of the payment. Allowable Values: 255 char max |
| metadata string Optional | Customer-defined additional information about the payment (for example, a check number). Allowable Values: 255 char max |
| hold_days integer Optional | Overrides the configured default number of days for which to hold ACH and check payments. Allowable Values: 0–30 |
Sample request body
JSON
Response body
| Fields | Description |
|---|---|
| token string Returned | Unique identifier of the payment. If in the detail_object, unique identifier of the detail object.Allowable Values: 36 char max |
| account_token string Returned | Unique identifier of the credit account on which the payment is made. Allowable Values: 36 char max Existing account token |
| method string Returned | Method of payment. Allowable Values: ACH, CHECK, DEBIT, CASH |
| payment_source_token string Conditionally returned | Unique identifier of the payment source. Required for ACH payments. Allowable Values: Existing payment source token |
| payment_schedule_token string Conditionally returned | Unique identifier of the payment schedule. Allowable Values: 36 char max |
| amount decimal Returned | Total amount of the payment. Allowable Values: 0 min |
| currency_code string Returned | Valid three-digit ISO 4217 currency code. Allowable Values: USD |
| status string Returned | Current status of the payment or refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED, REFUNDED, SYS_ERROR, ACH_ERROR |
| description string Returned | Description of the payment. Allowable Values: 255 char max |
| metadata string Conditionally returned | Customer-defined additional information about the payment (for example, a check number). Allowable Values: 255 char max |
| hold_days integer Returned | After a payment completes, the number of days to hold the available credit on the account before increasing it. Allowable Values: Any integer |
| hold_end_time datetime Conditionally returned | Date and time when the available credit hold is released. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| is_manually_released boolean Conditionally returned | Whether the available credit hold was manually released for this payment. Allowable Values: true, falseDefault value: false |
| on_hold boolean Conditionally returned | Whether the available credit is on hold for this payment. Allowable Values: true, falseDefault value: false |
| returned_details object Conditionally returned | Contains information on a returned payment. Allowable Values: Existing returned_details object |
| returned_details.return_code string Returned | Return code for the returned payment. For more, see NACHA ACH return codes. Allowable Values: Valid return code |
| returned_details.return_reason string Returned | Reason the payment was returned. For more, see NACHA ACH return codes. Allowable Values: Valid return reason |
| refund_details object Conditionally returned | Contains details for a refund. Allowable Values: Existing refund_details object |
| refund_details.method string Returned | Payment instrument used to issue the refund. Allowable Values: ACH, CHECK |
| refund_details.description string Returned | Description of the refund. Allowable Values: 255 char max |
| refund_details.status string Returned | Current status of the refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED |
| waive_returned_payment_fee boolean Conditionally returned | A value of true indicates that a returned payment fee should not be applied. The default value of this field is false.This field is only considered when transitioning the status of the fee to REFUNDED.Allowable Values: true, false |
| created_time datetime Returned | Date and time when the payment was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| updated_time datetime Returned | Date and time when the payment was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| transitions array of objects Returned | Contains one or more transitions objects, which contain information about a payment status transition.Allowable Values: One or more transitions objects |
| transitions[].token string Returned | Unique identifier of the payment status transition. Allowable Values: 36 char max |
| transitions[].account_token string Returned | Unique identifier of the credit account on which you want to transition a payment status. Allowable Values: Existing account token |
| transitions[].payment_token string Returned | Unique identifier of the payment whose status you want to transition. Allowable Values: Existing payment token |
| transitions[].status string Returned | Current status of the payment or refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED, REFUNDED, SYS_ERROR, ACH_ERROR |
| transitions[].created_time datetime Conditionally returned | Date and time when the payment transition was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| allocations array of objects Conditionally returned | List of objects that contain information about how a payment is allocated. Allowable Values: List of payment allocations |
| allocations[].bucket undefined Returned | Category to which a portion of the payment is allocated. Allowable Values: PRINCIPAL, INTEREST, FEES36 char max |
| allocations[].amount decimal Returned | Total amount of the payment allocation. Allowable Values: 0 min |
| program_migration_time datetime Conditionally returned | Date and time when the statement summary was migrated to Marqeta’s credit platform, in UTC. The value of this field is null if it has not been migrated.Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
List account payments
Action:GETEndpoint:
/credit/accounts/{account_token}/payments
Retrieve an array of payments on a credit account.
This endpoint supports sorting and pagination.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the credit account for which to retrieve payments. Send a GET request to /credit/accounts to retrieve existing credit account tokens.Allowable Values: Existing account token |
URL query parameters
| Fields | Description |
|---|---|
| start_date date Optional | Beginning of the date range of the payments to return. Allowable Values: Example: 2024-01-01 |
| end_date date Optional | End of the date range of the payments to return. Allowable Values: Example: 2024-02-01 |
| count integer Optional | Number of account payments resources to retrieve. Allowable Values: 1–100 |
| start_index integer Optional | Sort order index of the first resource in the returned array. Allowable Values: 0 min |
| sort_by string Optional | Field on which to sort. Prefix the field name with a hyphen (-) to sort in descending order. Omit the hyphen to sort in ascending order.NOTE: You must sort using system field names such as lastModifiedTime, and not by the field names appearing in response bodies such as last_modified_time.Allowable Values: lastModifiedTime, -lastModifiedTime |
| statuses array of strings Optional | Array of statuses by which to filter payments. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED, REFUNDED, SYS_ERROR, ACH_ERROR |
Response body
| Fields | Description |
|---|---|
| count integer Returned | Number of resources returned. Allowable Values: 1-10 |
| start_index integer Returned | Sort order index of the first resource in the returned array. Allowable Values: Any integer |
| end_index integer Returned | Sort order index of the last resource in the returned array. Allowable Values: Any integer |
| is_more boolean Returned | A value of true indicates that more unreturned resources exist.Allowable Values: true, false |
| data array of objects Returned | Contains one or more payments on a credit account. Allowable Values: One or more payment objects |
| data[].token string Returned | Unique identifier of the payment. If in the detail_object, unique identifier of the detail object.Allowable Values: 36 char max |
| data[].account_token string Returned | Unique identifier of the credit account on which the payment is made. Allowable Values: 36 char max Existing account token |
| data[].method string Returned | Method of payment. Allowable Values: ACH, CHECK, DEBIT, CASH |
| data[].payment_source_token string Conditionally returned | Unique identifier of the payment source. Required for ACH payments. Allowable Values: Existing payment source token |
| data[].payment_schedule_token string Conditionally returned | Unique identifier of the payment schedule. Allowable Values: 36 char max |
| data[].amount decimal Returned | Total amount of the payment. Allowable Values: 0 min |
| data[].currency_code string Returned | Valid three-digit ISO 4217 currency code. Allowable Values: USD |
| data[].status string Returned | Current status of the payment or refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED, REFUNDED, SYS_ERROR, ACH_ERROR |
| data[].description string Returned | Description of the payment. Allowable Values: 255 char max |
| data[].metadata string Conditionally returned | Customer-defined additional information about the payment (for example, a check number). Allowable Values: 255 char max |
| data[].hold_days integer Returned | After a payment completes, the number of days to hold the available credit on the account before increasing it. Allowable Values: Any integer |
| data[].hold_end_time datetime Conditionally returned | Date and time when the available credit hold is released. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| data[].is_manually_released boolean Conditionally returned | Whether the available credit hold was manually released for this payment. Allowable Values: true, falseDefault value: false |
| data[].on_hold boolean Conditionally returned | Whether the available credit is on hold for this payment. Allowable Values: true, falseDefault value: false |
| data[].returned_details object Conditionally returned | Contains information on a returned payment. Allowable Values: Existing returned_details object |
| data[].returned_details.return_code string Returned | Return code for the returned payment. For more, see NACHA ACH return codes. Allowable Values: Valid return code |
| data[].returned_details.return_reason string Returned | Reason the payment was returned. For more, see NACHA ACH return codes. Allowable Values: Valid return reason |
| data[].refund_details object Conditionally returned | Contains details for a refund. Allowable Values: Existing refund_details object |
| data[].refund_details.method string Returned | Payment instrument used to issue the refund. Allowable Values: ACH, CHECK |
| data[].refund_details.description string Returned | Description of the refund. Allowable Values: 255 char max |
| data[].refund_details.status string Returned | Current status of the refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED |
| data[].waive_returned_payment_fee boolean Conditionally returned | A value of true indicates that a returned payment fee should not be applied. The default value of this field is false.This field is only considered when transitioning the status of the fee to REFUNDED.Allowable Values: true, false |
| data[].created_time datetime Returned | Date and time when the payment was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| data[].updated_time datetime Returned | Date and time when the payment was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| data[].transitions array of objects Returned | Contains one or more transitions objects, which contain information about a payment status transition.Allowable Values: One or more transitions objects |
| data[].transitions[].token string Returned | Unique identifier of the payment status transition. Allowable Values: 36 char max |
| data[].transitions[].account_token string Returned | Unique identifier of the credit account on which you want to transition a payment status. Allowable Values: Existing account token |
| data[].transitions[].payment_token string Returned | Unique identifier of the payment whose status you want to transition. Allowable Values: Existing payment token |
| data[].transitions[].status string Returned | Current status of the payment or refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED, REFUNDED, SYS_ERROR, ACH_ERROR |
| data[].transitions[].created_time datetime Conditionally returned | Date and time when the payment transition was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| data[].allocations array of objects Conditionally returned | List of objects that contain information about how a payment is allocated. Allowable Values: List of payment allocations |
| data[].allocations[].bucket undefined Returned | Category to which a portion of the payment is allocated. Allowable Values: PRINCIPAL, INTEREST, FEES36 char max |
| data[].allocations[].amount decimal Returned | Total amount of the payment allocation. Allowable Values: 0 min |
| data[].program_migration_time datetime Conditionally returned | Date and time when the statement summary was migrated to Marqeta’s credit platform, in UTC. The value of this field is null if it has not been migrated.Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
Retrieve account payment
Action:GETEndpoint:
/credit/accounts/{account_token}/payments/{payment_token}
Retrieve a payment for a credit account.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the credit account for which to retrieve a payment. Send a GET request to /credit/accounts to retrieve existing credit account tokens.Allowable Values: Existing account token |
| payment_token string Required | Unique identifier of the payment to retrieve. Send a GET request to /credit/accounts/{token}/payments to retrieve existing payment tokens.Allowable Values: Existing payment token |
Response body
| Fields | Description |
|---|---|
| token string Returned | Unique identifier of the payment. If in the detail_object, unique identifier of the detail object.Allowable Values: 36 char max |
| account_token string Returned | Unique identifier of the credit account on which the payment is made. Allowable Values: 36 char max Existing account token |
| method string Returned | Method of payment. Allowable Values: ACH, CHECK, DEBIT, CASH |
| payment_source_token string Conditionally returned | Unique identifier of the payment source. Required for ACH payments. Allowable Values: Existing payment source token |
| payment_schedule_token string Conditionally returned | Unique identifier of the payment schedule. Allowable Values: 36 char max |
| amount decimal Returned | Total amount of the payment. Allowable Values: 0 min |
| currency_code string Returned | Valid three-digit ISO 4217 currency code. Allowable Values: USD |
| status string Returned | Current status of the payment or refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED, REFUNDED, SYS_ERROR, ACH_ERROR |
| description string Returned | Description of the payment. Allowable Values: 255 char max |
| metadata string Conditionally returned | Customer-defined additional information about the payment (for example, a check number). Allowable Values: 255 char max |
| hold_days integer Returned | After a payment completes, the number of days to hold the available credit on the account before increasing it. Allowable Values: Any integer |
| hold_end_time datetime Conditionally returned | Date and time when the available credit hold is released. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| is_manually_released boolean Conditionally returned | Whether the available credit hold was manually released for this payment. Allowable Values: true, falseDefault value: false |
| on_hold boolean Conditionally returned | Whether the available credit is on hold for this payment. Allowable Values: true, falseDefault value: false |
| returned_details object Conditionally returned | Contains information on a returned payment. Allowable Values: Existing returned_details object |
| returned_details.return_code string Returned | Return code for the returned payment. For more, see NACHA ACH return codes. Allowable Values: Valid return code |
| returned_details.return_reason string Returned | Reason the payment was returned. For more, see NACHA ACH return codes. Allowable Values: Valid return reason |
| refund_details object Conditionally returned | Contains details for a refund. Allowable Values: Existing refund_details object |
| refund_details.method string Returned | Payment instrument used to issue the refund. Allowable Values: ACH, CHECK |
| refund_details.description string Returned | Description of the refund. Allowable Values: 255 char max |
| refund_details.status string Returned | Current status of the refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED |
| waive_returned_payment_fee boolean Conditionally returned | A value of true indicates that a returned payment fee should not be applied. The default value of this field is false.This field is only considered when transitioning the status of the fee to REFUNDED.Allowable Values: true, false |
| created_time datetime Returned | Date and time when the payment was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| updated_time datetime Returned | Date and time when the payment was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| transitions array of objects Returned | Contains one or more transitions objects, which contain information about a payment status transition.Allowable Values: One or more transitions objects |
| transitions[].token string Returned | Unique identifier of the payment status transition. Allowable Values: 36 char max |
| transitions[].account_token string Returned | Unique identifier of the credit account on which you want to transition a payment status. Allowable Values: Existing account token |
| transitions[].payment_token string Returned | Unique identifier of the payment whose status you want to transition. Allowable Values: Existing payment token |
| transitions[].status string Returned | Current status of the payment or refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED, REFUNDED, SYS_ERROR, ACH_ERROR |
| transitions[].created_time datetime Conditionally returned | Date and time when the payment transition was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| allocations array of objects Conditionally returned | List of objects that contain information about how a payment is allocated. Allowable Values: List of payment allocations |
| allocations[].bucket undefined Returned | Category to which a portion of the payment is allocated. Allowable Values: PRINCIPAL, INTEREST, FEES36 char max |
| allocations[].amount decimal Returned | Total amount of the payment allocation. Allowable Values: 0 min |
| program_migration_time datetime Conditionally returned | Date and time when the statement summary was migrated to Marqeta’s credit platform, in UTC. The value of this field is null if it has not been migrated.Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
Release payment hold
Action:POSTEndpoint:
/credit/accounts/{account_token}/payments/{payment_token}/releasehold
Manually release a payment hold on a credit account.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the credit account on which a payment hold is being released. Send a GET request to /credit/accounts to retrieve existing credit account tokens.Allowable Values: Existing account token |
| payment_token string Required | Unique identifier of the payment currently on hold. Send a GET request to /credit/accounts/{account_token}/payments to retrieve existing payment tokens.Allowable Values: Existing payment token |
Response body
| Fields | Description |
|---|---|
| token string Returned | Unique identifier of the payment. If in the detail_object, unique identifier of the detail object.Allowable Values: 36 char max |
| account_token string Returned | Unique identifier of the credit account on which the payment is made. Allowable Values: 36 char max Existing account token |
| method string Returned | Method of payment. Allowable Values: ACH, CHECK, DEBIT, CASH |
| payment_source_token string Conditionally returned | Unique identifier of the payment source. Required for ACH payments. Allowable Values: Existing payment source token |
| payment_schedule_token string Conditionally returned | Unique identifier of the payment schedule. Allowable Values: 36 char max |
| amount decimal Returned | Total amount of the payment. Allowable Values: 0 min |
| currency_code string Returned | Valid three-digit ISO 4217 currency code. Allowable Values: USD |
| status string Returned | Current status of the payment or refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED, REFUNDED, SYS_ERROR, ACH_ERROR |
| description string Returned | Description of the payment. Allowable Values: 255 char max |
| metadata string Conditionally returned | Customer-defined additional information about the payment (for example, a check number). Allowable Values: 255 char max |
| hold_days integer Returned | After a payment completes, the number of days to hold the available credit on the account before increasing it. Allowable Values: Any integer |
| hold_end_time datetime Conditionally returned | Date and time when the available credit hold is released. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| is_manually_released boolean Conditionally returned | Whether the available credit hold was manually released for this payment. Allowable Values: true, falseDefault value: false |
| on_hold boolean Conditionally returned | Whether the available credit is on hold for this payment. Allowable Values: true, falseDefault value: false |
| returned_details object Conditionally returned | Contains information on a returned payment. Allowable Values: Existing returned_details object |
| returned_details.return_code string Returned | Return code for the returned payment. For more, see NACHA ACH return codes. Allowable Values: Valid return code |
| returned_details.return_reason string Returned | Reason the payment was returned. For more, see NACHA ACH return codes. Allowable Values: Valid return reason |
| refund_details object Conditionally returned | Contains details for a refund. Allowable Values: Existing refund_details object |
| refund_details.method string Returned | Payment instrument used to issue the refund. Allowable Values: ACH, CHECK |
| refund_details.description string Returned | Description of the refund. Allowable Values: 255 char max |
| refund_details.status string Returned | Current status of the refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED |
| waive_returned_payment_fee boolean Conditionally returned | A value of true indicates that a returned payment fee should not be applied. The default value of this field is false.This field is only considered when transitioning the status of the fee to REFUNDED.Allowable Values: true, false |
| created_time datetime Returned | Date and time when the payment was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| updated_time datetime Returned | Date and time when the payment was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| transitions array of objects Returned | Contains one or more transitions objects, which contain information about a payment status transition.Allowable Values: One or more transitions objects |
| transitions[].token string Returned | Unique identifier of the payment status transition. Allowable Values: 36 char max |
| transitions[].account_token string Returned | Unique identifier of the credit account on which you want to transition a payment status. Allowable Values: Existing account token |
| transitions[].payment_token string Returned | Unique identifier of the payment whose status you want to transition. Allowable Values: Existing payment token |
| transitions[].status string Returned | Current status of the payment or refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED, REFUNDED, SYS_ERROR, ACH_ERROR |
| transitions[].created_time datetime Conditionally returned | Date and time when the payment transition was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| allocations array of objects Conditionally returned | List of objects that contain information about how a payment is allocated. Allowable Values: List of payment allocations |
| allocations[].bucket undefined Returned | Category to which a portion of the payment is allocated. Allowable Values: PRINCIPAL, INTEREST, FEES36 char max |
| allocations[].amount decimal Returned | Total amount of the payment allocation. Allowable Values: 0 min |
| program_migration_time datetime Conditionally returned | Date and time when the statement summary was migrated to Marqeta’s credit platform, in UTC. The value of this field is null if it has not been migrated.Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
Transition account payment status
Action:POSTEndpoint:
/credit/accounts/{account_token}/payments/{payment_token}/transitions
Transition a credit account payment’s status to a new status.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the credit account for which you want to transition a payment status. Send a GET request to /credit/accounts to retrieve existing credit account tokens.Allowable Values: Existing account token |
| payment_token string Required | Unique identifier of the payment whose status you want to transition. Send a GET request to /credit/accounts/{account_token}/payments endpoint to retrieve existing payment tokens for a given account.Allowable Values: Existing payment token |
Request body
| Fields | Description |
|---|---|
| token string Optional | Unique identifier of the payment status transition. Allowable Values: 36 char max |
| status string Required | Current status of the payment or refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED, REFUNDED, SYS_ERROR, ACH_ERROR |
| refund_details object Optional | Contains details for a refund. Allowable Values: method, description |
| refund_details.method string Required | Payment instrument used to issue the refund. Allowable Values: ACH, CHECK |
| refund_details.description string Required | Description of the refund. Allowable Values: 255 char max |
| waive_returned_payment_fee boolean Optional | A value of true indicates that a returned payment fee should not be applied if one is applicable. This is false by default. This field is only considered during a transition to REFUNDEDAllowable Values: true, false |
Sample request body
JSON
Response body
| Fields | Description |
|---|---|
| token string Returned | Unique identifier of the payment status transition. Allowable Values: 36 char max |
| account_token string Returned | Unique identifier of the credit account on which you want to transition a payment status. Allowable Values: Existing account token |
| payment_token string Returned | Unique identifier of the payment whose status you want to transition. Allowable Values: Existing payment token |
| status string Returned | Current status of the payment or refund. Allowable Values: INITIATED, PENDING, PROCESSING, SUBMITTED, CANCELLED, COMPLETED, RETURNED, REFUNDED, SYS_ERROR, ACH_ERROR |
| created_time datetime Conditionally returned | Date and time when the payment transition was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Resend credit event notification
Action:POSTEndpoint:
/credit/webhooks/{event_type}/{resource_token}
Resends a credit event notification to your webhook endpoint.
Although you send this request as a POST, all parameters are passed in the URL and the body is empty. The event notification is resent to your webhook endpoint and also returned in the response to this request.
For details on how to configure your webhook endpoint, see the About Webhooks tutorial. For the complete /webhooks endpoint reference, see Webhooks.
URL path parameters
| Fields | Description |
|---|---|
| event_type string Required | Specifies the type of event you want to resend. Allowable Values: ledgerentry, journalentry, accounttransition, accountstatement, paymenttransition, delinquencytransition, paymentreminders, substatus, accountsignupbonus |
| resource_token string Required | Unique identifier of the resource for which you want to resend a notification. - Send a GET request to /credit/accounts/{account_token}/journalentries to retrieve existing journal entry tokens.- Send a GET request to /credit/accounts/{account_token}/ledgerentries to retrieve existing ledger entry tokens.- Send a GET request to /accounts/{account_token}/accounttransitions to retrieve existing account transition tokens.- Send a GET request to /credit/accounts/{account_token}/payments/{payment_token} to retrieve existing payment transition tokens.- Send a GET request to /accounts/{account_token}/statements to retrieve existing statement summary tokens.- Send a GET request to /accounts/{account_token}/delinquencystate/transitions to retrieve existing delinquency state transition tokens.- Send a GET request to /accounts/{account_token}/statements/{statement_summary_token}/paymentreminders/{token} to retrieve existing payment reminder tokens.- Send a GET request to /credit/substatuses to retrieve existing substatus tokens.- Send a GET request to /credit/accounts to retrieve existing credit account tokens and identify the specific account for the resend event.Allowable Values: Existing journal entry token, ledger entry token, account transition token, payment transition token, statement summary token, delinquency transition token, or substatus token |
Response body
| Fields | Description |
|---|---|
| unused string Conditionally returned | Event notification that was resent to your webhook endpoint. Allowable Values: Valid event notification |
Sample response body
The following code block shows a sample of a resentcreditaccounttransitions event.
JSON
creditaccountstatements event.
JSON
creditjournalentries event.
JSON
creditledgerentries event.
JSON
creditpaymenttransitions event.
JSON
creditdelinquencytransitions event.
JSON
substatus event.
JSON
accountsignupbonus event.
JSON