Account Transitions

Use the account transitions endpoints to create and retrieve account transitions on Marqeta’s credit platform. An account transition occurs when a credit account transitions to a new status. To receive webhook notifications when account transition events occur, see Credit account transition events in Event Types.

Transition account status

Action: POST
Endpoint: /credit/accounts/{account_token}/accounttransitions Transition a credit account to a new status.

URL path parameters

Fields	Description
account_token string Required	The unique identifier of the credit account for which to transition a status. Send a `GET` request to `/credit/accounts` to retrieve existing credit account tokens. Allowable Values: Existing account token

Request body

Fields	Description
status string Required	Status of the credit account. NOTE`CHARGE_OFF` is not an allowable value for `original_status`. Allowable Values: `UNACTIVATED`, `ACTIVE`, `SUSPENDED`, `TERMINATED`, `CHARGE_OFF`
token string Optional	Unique identifier of the credit account transition. Allowable Values: 36 char max

Sample request body

JSON

{
  "status": "ACTIVE"
}

Response body

Fields	Description
token string Returned	Unique identifier of the credit account transition. Allowable Values: 36 char max
account_token string Returned	Unique identifier of the credit account for which to transition a status. Allowable Values: 36 char max
original_status string Returned	Status of the credit account prior to transition. Allowable Values: `UNACTIVATED`, `ACTIVE`, `SUSPENDED`, `TERMINATED`, `CHARGE_OFF`
status string Returned	Status to which the credit account transitioned. Allowable Values: `UNACTIVATED`, `ACTIVE`, `SUSPENDED`, `TERMINATED`, `CHARGE_OFF`
created_time datetime Returned	Date and time when the transition record was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ

Sample response body

JSON

{
  "token": "my_account_transition_token1234",
  "account_token": "my_account_token_12",
  "original_status": "UNACTIVATED",
  "status": "ACTIVE",
  "created_time": "2021-09-03T19:22:45Z"
}

List account transitions

Action: GET
Endpoint: /credit/accounts/{account_token}/accounttransitions Retrieve an array of transitions on a credit account. This endpoint supports sorting and pagination.

URL path parameters

Fields	Description
account_token string Required	The unique identifier of the credit account for which you want to retrieve transitions. Send a `GET` request to `/credit/accounts` to retrieve existing credit account tokens. Allowable Values: Existing account token

URL query parameters

Fields	Description
count integer Optional	The number of 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 `createdTime`, and not by the field names appearing in response bodies such as `created_time`. Allowable Values: `createdTime`, `-createdTime`

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 account transitions. Allowable Values: One or more account transition objects
data[].token string Returned	Unique identifier of the credit account transition. Allowable Values: 36 char max
data[].account_token string Returned	Unique identifier of the credit account for which to transition a status. Allowable Values: 36 char max
data[].original_status string Returned	Status of the credit account prior to transition. Allowable Values: `UNACTIVATED`, `ACTIVE`, `SUSPENDED`, `TERMINATED`, `CHARGE_OFF`
data[].status string Returned	Status to which the credit account transitioned. Allowable Values: `UNACTIVATED`, `ACTIVE`, `SUSPENDED`, `TERMINATED`, `CHARGE_OFF`
data[].created_time datetime Returned	Date and time when the transition record was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ

Sample response body

JSON

{
  "count": 1,
  "start_index": 0,
  "end_index": 0,
  "is_more": false,
  "data": [
    {
      "token": "my_account_transition_token1234",
      "account_token": "my_account_token_12",
      "original_status": "UNACTIVATED",
      "status": "ACTIVE",
      "created_time": "2021-09-03T19:22:45Z"
    }
  ]
}

Retrieve account transition

Action: GET
Endpoint: /credit/accounts/{account_token}/accounttransitions/{token} Retrieve a transition for a credit account.

URL path parameters

Fields	Description
account_token string Required	The unique identifier of the credit account for which you want to retrieve a transition. Send a `GET` request to `/credit/accounts` to retrieve existing credit account tokens. Allowable Values: Existing account token
token string Required	The unique identifier of the account transition you want to retrieve. Send a `GET` request to `/credit/accounts/{account_token}/accounttransitions` to retrieve existing account transition tokens. Allowable Values: Existing account transition token

Response body

Fields	Description
token string Returned	Unique identifier of the credit account transition. Allowable Values: 36 char max
account_token string Returned	Unique identifier of the credit account for which to transition a status. Allowable Values: 36 char max
original_status string Returned	Status of the credit account prior to transition. Allowable Values: `UNACTIVATED`, `ACTIVE`, `SUSPENDED`, `TERMINATED`, `CHARGE_OFF`
status string Returned	Status to which the credit account transitioned. Allowable Values: `UNACTIVATED`, `ACTIVE`, `SUSPENDED`, `TERMINATED`, `CHARGE_OFF`
created_time datetime Returned	Date and time when the transition record was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ

Sample response body

JSON

{
  "token": "my_account_transition_token1234",
  "account_token": "my_account_token_12",
  "original_status": "UNACTIVATED",
  "status": "ACTIVE",
  "created_time": "2021-09-03T19:22:45Z"
}

Resend credit event notification

Action: POST
Endpoint: /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`
resource_token string Required	The 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 transition tokens. Allowable Values: Existing journal entry token, ledger entry token, account transition token, payment transition token, statement summary token, or delinquency transition token

Response body

Fields	Description
unused string Conditionally returned	The 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 resent creditaccounttransitions event.

JSON

{
  "token": "my_credit_account_transition_token1234",
  "account_token": "my_credit_account_token1234",
  "original_status": "UNACTIVATED",
  "status": "ACTIVE",
  "created_time": "2021-08-18T20:25:10.408Z"
}

The following code block shows a sample of a resent creditaccountstatements event.

JSON

{
  "token": "my_credit_account_statement_token",
  "account_token": "my_credit_account_token",
  "opening_balance": 496.45,
  "closing_balance": 506.41,
  "credit_limit": 500,
  "available_credit": 0,
  "past_due_amount": 10,
  "purchases": 0,
  "interest": 4.96,
  "fees": 15,
  "credits": 0,
  "payments": 10,
  "days_in_billing_cycle": 31,
  "cycle_type": "REVOLVING",
  "opening_date": "2023-03-01T05:00:00.000Z",
  "closing_date": "2023-04-01T03:59:59.999Z",
  "created_time": "2021-08-18T22:04:31.261Z"
}

The following code block shows a sample of a resent creditjournalentries event.

JSON

{
  "token": "my_journal_entry_token1234",
  "related_token": null,
  "root_token": null,
  "account_token": "my_credit_account_token1234",
  "card_token": "my_credit_card_token1234",
  "status": "PENDING",
  "group": "PURCHASE",
  "type": "authorization",
  "id": "12345678",
  "amount": 10,
  "currency_code": "USD",
  "memo": "Jane's Bakery",
  "request_time": "2021-08-18T22:06:52.000Z",
  "impact_time": "2021-08-18T22:07:21.422Z",
  "created_time": "2021-08-18T22:07:21.422Z",
  "dispute_token": null,
  "detail_token": "my_detail_token1234",
  "detail_object": {
    "type": "authorization",
    "state": "PENDING",
    "identifier": "234",
    "token": "my_detail_token1234",
    "user_token": "my_user_token",
    "acting_user_token": "my_user_token",
    "card_token": "my_credit_card_token1234",
    "gpa": {
      "currency_code": "USD",
      "ledger_balance": 510.87,
      "available_balance": 0,
      "credit_balance": 0,
      "pending_credits": 0,
      "impacted_amount": -10,
      "balances": {
        "USD": {
          "currency_code": "USD",
          "ledger_balance": 510.87,
          "available_balance": 0,
          "credit_balance": 0,
          "pending_credits": 0,
          "impacted_amount": -10
        }
      }
    },
    "gpa_order": {
      "token": "my_gpa_order_token1234",
      "amount": 10,
      "created_time": "2021-08-18T22:06:53Z",
      "last_modified_time": "2021-08-18T22:06:53Z",
      "transaction_token": "my_transaction_token1234",
      "state": "PENDING",
      "response": {
        "code": "0000",
        "memo": "Approved or completed successfully"
      },
      "funding": {
        "amount": 10,
        "source": {
          "type": "programgateway",
          "token": "**********1ab2",
          "active": true,
          "name": "credit_backed_funding_source",
          "is_default_account": false,
          "created_time": "2021-10-14T17:26:35Z",
          "last_modified_time": "2021-10-14T17:26:35Z"
        },
        "gateway_log": {
          "order_number": "my_gateway_token12345",
          "transaction_id": "my_transaction_id1234",
          "message": "Approved or completed successfully",
          "duration": 485,
          "timed_out": false,
          "response": {
            "code": "200",
            "data": {
              "jit_funding": {
                "token": "my_jit_funding_token1234",
                "method": "pgfs.authorization",
                "user_token": "my_user_token",
                "acting_user_token": "my_user_token",
                "amount": 10
              }
            }
          }
        }
      },
      "funding_source_token": "**********1ab2",
      "jit_funding": {
        "token": "my_transaction_id1234",
        "method": "pgfs.authorization",
        "user_token": "my_user_token",
        "acting_user_token": "my_user_token",
        "amount": 10
      },
      "user_token": "my_user_token",
      "currency_code": "USD"
    },
    "duration": 837,
    "created_time": "2021-08-18T22:06:52Z",
    "user_transaction_time": "2021-08-18T22:06:52Z",
    "settlement_date": "2021-08-18T00:00:00Z",
    "request_amount": 10,
    "amount": 10,
    "currency_code": "USD",
    "approval_code": "974406",
    "response": {
      "code": "0000",
      "memo": "Approved or completed successfully"
    },
    "network": "DISCOVER",
    "acquirer_fee_amount": 0,
    "acquirer": {
      "system_trace_audit_number": "376582"
    },
    "user": {
      "metadata": {
        "key1": "value1",
        "key2": "value2",
        "notification_email": "user@domain.com",
        "notification_language": "spa"
      }
    },
    "card": {
      "last_four": "9949",
      "metadata": {}
    },
    "issuer_received_time": "2021-08-18T22:06:52.771Z",
    "issuer_payment_node": "f8205a67b12b90d695b15704a64c074b",
    "network_reference_id": "484311571095",
    "card_acceptor": {
      "mid": "1234",
      "mcc": "6411",
      "name": "Jane's Bakery",
      "street_address": "1989 Fillmore St",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94115",
      "country_code": "USA"
    },
    "pos": {
      "pin_present": false,
      "partial_approval_capable": true,
      "purchase_amount_only": false,
      "is_recurring": false,
      "is_installment": false
    }
  }
}

The following code block shows a sample of a resent creditledgerentries event.

JSON

{
  "token": "my_ledger_entry_token1234",
  "related_token": null,
  "root_token": null,
  "account_token": "my_credit_account_token1234",
  "card_token": "my_credit_card_token1234",
  "status": "PENDING",
  "group": "PURCHASE",
  "type": "authorization",
  "id": "12345678",
  "amount": 10,
  "currency_code": "USD",
  "memo": "Jane's Bakery",
  "request_time": "2021-08-18T22:06:52.000Z",
  "impact_time": "2021-08-18T22:07:21.422Z",
  "created_time": "2021-08-18T22:07:21.422Z",
  "dispute_token": null,
  "detail_token": "my_detail_token1234",
  "detail_object": {
    "type": "authorization",
    "state": "PENDING",
    "identifier": "234",
    "token": "my_detail_token1234",
    "user_token": "my_user_token",
    "acting_user_token": "my_user_token",
    "card_token": "my_credit_card_token1234",
    "gpa": {
      "currency_code": "USD",
      "ledger_balance": 510.87,
      "available_balance": 0,
      "credit_balance": 0,
      "pending_credits": 0,
      "impacted_amount": -10,
      "balances": {
        "USD": {
          "currency_code": "USD",
          "ledger_balance": 510.87,
          "available_balance": 0,
          "credit_balance": 0,
          "pending_credits": 0,
          "impacted_amount": -10
        }
      }
    },
    "gpa_order": {
      "token": "my_gpa_order_token1234",
      "amount": 10,
      "created_time": "2021-08-18T22:06:53Z",
      "last_modified_time": "2021-08-18T22:06:53Z",
      "transaction_token": "my_transaction_token1234",
      "state": "PENDING",
      "response": {
        "code": "0000",
        "memo": "Approved or completed successfully"
      },
      "funding": {
        "amount": 10,
        "source": {
          "type": "programgateway",
          "token": "**********1ab2",
          "active": true,
          "name": "credit_backed_funding_source",
          "is_default_account": false,
          "created_time": "2021-10-14T17:26:35Z",
          "last_modified_time": "2021-10-14T17:26:35Z"
        },
        "gateway_log": {
          "order_number": "my_gateway_token12345",
          "transaction_id": "my_transaction_id1234",
          "message": "Approved or completed successfully",
          "duration": 485,
          "timed_out": false,
          "response": {
            "code": "200",
            "data": {
              "jit_funding": {
                "token": "my_jit_funding_token1234",
                "method": "pgfs.authorization",
                "user_token": "my_user_token",
                "acting_user_token": "my_user_token",
                "amount": 10
              }
            }
          }
        }
      },
      "funding_source_token": "**********1ab2",
      "jit_funding": {
        "token": "my_transaction_id1234",
        "method": "pgfs.authorization",
        "user_token": "my_user_token",
        "acting_user_token": "my_user_token",
        "amount": 10
      },
      "user_token": "my_user_token",
      "currency_code": "USD"
    },
    "duration": 837,
    "created_time": "2021-08-18T22:06:52Z",
    "user_transaction_time": "2021-08-18T22:06:52Z",
    "settlement_date": "2021-08-18T00:00:00Z",
    "request_amount": 10,
    "amount": 10,
    "currency_code": "USD",
    "approval_code": "974406",
    "response": {
      "code": "0000",
      "memo": "Approved or completed successfully"
    },
    "network": "DISCOVER",
    "acquirer_fee_amount": 0,
    "acquirer": {
      "system_trace_audit_number": "376582"
    },
    "user": {
      "metadata": {
        "key1": "value1",
        "key2": "value2",
        "notification_email": "user@domain.com",
        "notification_language": "spa"
      }
    },
    "card": {
      "last_four": "9949",
      "metadata": {}
    },
    "issuer_received_time": "2021-08-18T22:06:52.771Z",
    "issuer_payment_node": "f8205a67b12b90d695b15704a64c074b",
    "network_reference_id": "484311571095",
    "card_acceptor": {
      "mid": "1234",
      "mcc": "6411",
      "name": "Jane's Bakery",
      "street_address": "1989 Fillmore St",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94115",
      "country_code": "USA"
    },
    "pos": {
      "pin_present": false,
      "partial_approval_capable": true,
      "purchase_amount_only": false,
      "is_recurring": false,
      "is_installment": false
    }
  }
}

The following code block shows a sample of a resent creditpaymenttransitions event.

JSON

{
  "token": "my_payment_transition_token1234",
  "account_token": "my_credit_account_token1234",
  "payment_token": "my_credit_account_payment_token1234",
  "status": "COMPLETED",
  "refund_details": null,
  "created_time": "2021-08-17T18:26:47.591Z"
}

The following code block shows a sample of a resent creditdelinquencytransitions event.

JSON

{
  "token": "my_delinquency_transition_token1234",
  "account_token": "my_credit_account_token1234",
  "transition_trigger_reason": "STATEMENT_GENERATION",
  "transition_trigger_time": "2023-03-01 04:59:59.999",
  "original_status": "CURRENT",
  "status": "DELINQUENT",
  "impact_time": "2023-03-01 04:59:59.999",
  "total_past_due": 100,
  "current_due": 40,
  "total_due": 140,
  "oldest_payment_due_date": "2023-02-01 04:59:59.999",
  "bucket_count": 2,
  "is_invalidated": false,
  "created_time": "2023-03-01 04:59:59.999",
  "updated_time": "2023-03-01 04:59:59.999"
}

​Transition account status

​URL path parameters

​Request body

​Sample request body

​Response body

​Sample response body

​List account transitions

​URL path parameters

​URL query parameters

​Response body

​Sample response body

​Retrieve account transition

​URL path parameters

​Response body

​Sample response body

​Resend credit event notification

​URL path parameters

​Response body

​Sample response body

Transition account status

URL path parameters

Request body

Sample request body

Response body

Sample response body

List account transitions

URL path parameters

URL query parameters

Response body

Sample response body

Retrieve account transition

URL path parameters

Response body

Sample response body

Resend credit event notification

URL path parameters

Response body

Sample response body