Check Returns

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.

Check return debit

Action: POST
Endpoint: /checkreturn

Use this endpoint to create and start the process of refunding a check.

Request body

Fields	Description
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

Fields	Description
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"
}

​Check return debit

​Request body

​Sample request body

​Response body

​Sample response body

Check return debit

Request body

Sample request body

Response body

Sample response body