Represents payments and their corresponding attempts for completion initiated by Check on behalf of a company
See the Payments guide for more information
{
"id": "pyt_vIFHhvyGN47ej1upyIT8",
"status": "paid",
"amount": "4522.0400",
"type": "company_cash_requirement",
"parent_type": "payroll",
"parent_id": "pay_ENA4k8LMHbgpV07GLGSv",
"payment_attempts": [
{
"id": "pya_GaeJoEAzbqqc2D9GMfOF",
"created_at": "2022-02-18T21:32:44.957364Z",
"expected_completion_date": "2022-02-25",
"status": "paid",
"failure_code": null,
"payment_method": "ach",
"payment_instrument": "bnk_GaeJoEAzbqqc2D9GMfOF",
"wire_details": null
},
],
"can_retry": false,
"can_refund": false,
"direction": "debit"
}
Attribute | Description |
---|---|
id string | Unique identifier for the payment. |
status string | Status of the payment in its lifecycle. One of draft , processing , paid , failed , or refunded |
amount string | The amount of the payment, expressed as a decimal. |
type string | The type of payment. One of company_cash_requirement , employee_net_pay or refund |
parent_type string | The parent type of the payment One of payroll , payroll_item , contractor_payment , or refund |
parent_id string | The id of the parent of the payment (refer to the parent_type field for the potential parents).An id can be one of pay_... , pyi_... , cpa_... , or pyt_... |
payment_attempts array of objects | A list of associated attempts to fulfill the payment. Described in detail below. |
can_retry boolean | Boolean representing whether a particular payment can be retried. A payment must be in a failed state to be eligible for retry. |
can_refund boolean | Boolean representing whether a particular payment can be refunded. Only credit payments in a failed state are eligible for refunds. |
direction string | String describing the direction of the payment from the caller's perspective. Direction can be either credit or debit |
Objects in the payment_attempts
array
Attribute | Description |
---|---|
id string | Id of the payment attempt |
created_at datetime | Datetime at which the payment attempt was created |
expected_completion_date date | The date on which the payment is expected to settle. |
status string | Status of the payment attempt in its lifecycle. One of draft , processing , paid , failed , or refunded |
failure_code string | A code describing the reason for a payment attempt failure. One of insufficient_funds , account_closed , invalid_account_number , debit_not_authorized , declined , could_not_process , account_frozen , or invalid_account_holder |
payment_method string | A field describing the method of which the payment attempt was executed. One of ach , wire , or manual |
payment_instrument string | If relevant, the id of the corresponding instrument used to complete a payment attempt. When payment_method is set to ach , payment_instrument will be a bank account id |
wire_details object | An object describing the relevant details to wire Check for a payment. Present if payment_method is set to wire |
The wire_details
object
Attribute | Description |
---|---|
account_number string | Account number for a Check-controlled bank account for wiring purposes |
routing_number string | Routing number used for wiring purposes. |
bank_name string | Name of the bank used for wiring purposes. |
account_name string | Name of the bank account used for wiring purposes. |
account_address string | Address of the bank account used for wiring purposes. |
amount number | Decimal-quoted amount of money to wire Check. |