Skip to main content
Note
This feature is currently in beta and subject to change. To learn more about the Beta program for this feature, contact your Marqeta representative.
Use the /checkreturn endpoint to obtain a physical check for a user after terminating their account with a residual balance.

Check return debit

Action: POST
Endpoint: /checkreturn
Use this endpoint to create and start the process of refunding a check.

Request body

FieldsDescription
card_holder_token

string

Required
Token representation of the cardholder.

Allowable Values:

Existing cardholder token

Sample request body

The URL below is an example of a request. Simply replace HOSTNAME with the URL provided by Marqeta for your organization.
HTML
{
   https://HOSTNAME.marqeta.com/v3/checkreturn/4a13199c-27b1-4d11-9aa3-e2920f5f02f4
}

Response body

FieldsDescription
amount

decimal

Conditionally returned
Amount to be returned. This will be the user’s total GPA balance. Included in the response if the check return is successful.

Allowable Values:

Format: 0.00
token

string

Conditionally returned
Unique identifier of the check return debit. Included in the response if the check return is successful.

Allowable Values:

Existing token

Sample response body

JSON
{
   "amount": 5.00,
   "token": "f2bd642e-6b2c-4bf5-8be5-6ab781a3736c"
}