Paper Checks

Documentation | Checkbook

Overview

Recipients receive their paper check via USPS first class mail. Please be aware that Paper Checks generally cost more to send than Digital Payments.

👍

Verified Bank Account Needed

In order to be able to send checks, you need to have a verified bank account in our system. Please refer to the Add a Bank Account section for instructions about adding a bank account to your Checkbook.io profile.

API Basic

The API reference for sending a Paper Check can be found here. The interactive form allows you to test the API endpoint in our demo environment right from the reference page.

Request

curl --request POST \
  --url https://demo.checkbook.io/v3/check/physical \
  --header 'accept: application/json' \
  --header 'authorization: d6aa2703655f4ba2af2a56202961ca86:dXbCgzYBMibj8ZwuQMd2NXr6rtvjZ8' \
  --header 'content-type: application/json' \
  --data '{"recipient":{"line_1":"1234 N. 1st Street","line_2":"#56","city":"San Francisco","state":"CA","zip":"12345","country":"US"},"amount":5}'

Response

{
    "amount":5,
    "date":"2019-06-10 18:01:59",
    "description":NULL,
    "id":"5e97134cd23345c3af3798d030b255e7",
    "image_uri":"https://checkbook-checks-dev.s3.amazonaws.com/8d43176b-9d3d-4ba2-8cc2-1dfe1e3694ee.png",
    "name":"Widgets Inc.",
    "number":8243,
    "recipient":{
        "city":"San Francisco",
        "country":"US",
        "line_1":"1234 N. 1st Street",
        "line_2":"#56",
        "state":"CA",
        "zip":"12345"
    },
    "status":"IN_PROCESS"
}

The description field can be 2054 characters long. For descriptions over 80 characters, we will automatically generate a link with the full remittance info.

📘

Note

The previous request is for the demo environment. You will need to use either the sandbox endpoint if you want to send test checks, or the production endpoint if you want to send real checks.

ENDPOINTS

POST/v3/check/physical


What’s Next