Repayments

Repayments represent payments made towards a loan. Repayments from a deposit account on the same bank on the Unit platform can be made using book repayment, whereas repayments from accounts on other banks, would be made using ACH debit repayments. Once you create a repayment, a repayment.created event will be raised.

When creating a repayment, you are required to specify 3 accounts:

Account: The deposit account that the repayment funds will be deposited in.
CreditAccount: The credit account that the repayment is made against (e.g. the credit account that represents the customer's charge card debt).
Counterparty: The deposit account that the repayment funds will be taken from.

If the repayment is successfully created, either a book payment or an ACH debit payment will be created, depending on the type of repayment, and a payment.created event will be raised

Capital Partner Repayments

When using the Capital Partner as part of your lending program, end-customer repayments should be made to the capital partner. These repayments can be made using capital partner ACH repayment or capital partner Book repayment. You do not need to provide the details of the receiving account when creating these repayments, as the capital partner's account is a pre-configured account in the org-bank-agreement.

Repayment Statuses

Repayments share the status of the payment type they resulted in (Book or ACH debit). When the Repayment status changes, a repayment.statusChanged event will be raised.

Book Repayment Statuses

Status	Description
Sent	The repayment has been completed and the funds have been debited from the `counterparty`, deposited into the `account`, and the `creditAccount` balance has been updated .
Rejected	The repayment has been rejected, either because the amount exceeds the balance of the `creditAccount`, or because the book payment has been rejected.

ACH Repayment Statuses

Status	Description	Possible Next states
Pending	The repayment and associated payment have been created, but have not yet been transmitted to the ACH network.	The status will change to `clearing` once the payment is transmitted to the ACH network, or to `canceled` (if the payment is canceled).
PendingReview	The ACH debit payment has been sent to manual review in cases of elevated fraud risk	`rejected` (if rejected by the reviewer) `pending` (if approved by the reviewer) or `canceled` (if the payment is canceled).
Clearing	The funds have been debited from the `counterparty` and are now in clearing to mitigate the risk of ACH debit fraud	`sent` (once the clearing period is over) or `returned` if the payment was returned before the clearing period ends.
Sent	The funds have been cleared and released to the `account`. The `creditAccount` balance has been updated	This is a final state, unless the payment is `returned`.
Returned	The bank that the funds were pulled from has returned the ACH payment. The funds have been returned from the `account` to the `counterparty` and the `creditAccount` balance has been updated.
Rejected	The repayment has been rejected, either because the amount exceeds the balance of the `creditAccount`, or because the ACH has been rejected
Canceled	The ACH payment has been canceled

Create Book Repayment

Creates a repayment for a credit account.

Book Repayment creation requests support Idempotency, ensuring that performing multiple identical requests will have the same result as a single request.

Verb	`POST`
Url	`https://api.s.unit.sh/repayments`
Required Scope	`repayments-write` or `payments-write`
Data Type	`repayment`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
description	string	Repayment description (maximum of 80 characters), this will show up on statement of the counterparty.
amount	Integer	The amount (cents) to repay.
transactionSummaryOverride	string	If this field is populated, its contents will be returned as the bookTransaction’s summary field (maximum of 100 characters).
tags	object	Optional. See Tags.
idempotencyKey	string	Optional. See Idempotency.

Relationships

Name	Type	Description
account	JSON:API Relationship	The Deposit Account the repayment will be deposited into.
creditAccount	JSON:API Relationship	The Credit Account that the repayment is made against.
counterpartyAccount	JSON:API Relationship	The Deposit Account the repayment funds are taken from.

Example Request:
curl -X POST 'https://api.s.unit.sh/repayments'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "bookRepayment",
    "attributes": {
      "amount": 20,
      "description": "test",
      "transactionSummaryOverride": "override",
      "idempotencyKey": "3a1a33be-4e12-4603-9ed0-820922389fb8"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "depositAccount",
          "id": "10006"
        }
      },
      "creditAccount": {
        "data": {
          "type": "creditAccount",
          "id": "10007"
        }
      },
      "counterpartyAccount": {
        "data": {
          "type": "account",
          "id": "10008"
        }
      }
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Field	Type	Description
data	BookRepayment	The requested resource after the operation was completed.

Example Response:
{
  "data": {
    "type": "bookRepayment",
    "id": "4",
    "attributes": {
      "createdAt": "2022-09-19T09:10:09.206Z",
      "updatedAt": "2022-09-19T09:10:09.206Z",
      "amount": 20,
      "status": "Sent"
    },
    "relationships": {
      "counterparty": {
        "data": {
          "type": "account",
          "id": "10008"
        }
      },
      "account": {
        "data": {
          "type": "account",
          "id": "10006"
        }
      },
      "creditAccount": {
        "data": {
          "type": "creditAccount",
          "id": "10007"
        }
      },
      "customer": {
        "data": {
          "type": "customer",
          "id": "10002"
        }
      },
      "org": {
        "data": {
          "type": "org",
          "id": "2"
        }
      },
      "payment": {
        "data": {
          "type": "payment",
          "id": "5"
        }
      }
    }
  }
}

Create ACH Repayment

Creates a repayment for a credit account. Both repayment.created and payment.created events are raised when the call is successful.

ACH Repayment creation requests support Idempotency, ensuring that performing multiple identical requests will have the same effect as performing a single request.

Verb	`POST`
Url	`https://api.s.unit.sh/repayments`
Required Scope	`repayments-write` or `payments-write`
Data Type	`repayment`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
description	string	Payment description (maximum of 10 characters), also known as Company Entry Description, this will show up on statement of the counterparty.
amount	Integer (Cents)	The amount to repay.
addenda	string	Optional, additional payment description (maximum of 80 characters), not all institutions present that.
tags	object	Optional. See Tags.
sameDay	boolean	Optional, default is `false`. See Same Day ACH.
secCode	string	Optional. See Use a custom SEC Code.
idempotencyKey	string	Optional. See Idempotency.

Relationships

Name	Type	Description
account	JSON:API Relationship	The Deposit Account the repayment will be deposited into.
creditAccount	JSON:API Relationship	The Credit Account that the repayment is made against.
counterparty	JSON:API Relationship	The ACH Counterparty the repayment will come from.

Example Request:
curl -X POST 'https://api.s.unit.sh/repayments'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "achRepayment",
    "attributes": {
      "amount": 200,
      "description": "test"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "depositAccount",
          "id": "10076"
        }
      },
      "creditAccount": {
        "data": {
          "type": "creditAccount",
          "id": "10082"
        }
      },
      "counterparty": {
        "data": {
          "type": "counterparty",
          "id": "3"
        }
      }
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Field	Type	Description
data	AchRepayment	The requested resource after the operation was completed.

Example Response:
{
  "data": {
    "type": "achRepayment",
    "id": "1",
    "attributes": {
      "createdAt": "2022-09-19T09:02:13.343Z",
      "updatedAt": "2022-09-19T09:02:13.343Z",
      "amount": 200,
      "status": "Pending"
    },
    "relationships": {
      "org": {
        "data": {
          "type": "org",
          "id": "1"
        }
      },
      "account": {
        "data": {
          "type": "account",
          "id": "10003"
        }
      },
      "counterparty": {
        "data": {
          "type": "counterparty",
          "id": "1"
        }
      },
      "creditAccount": {
        "data": {
          "type": "creditAccount",
          "id": "10007"
        }
      },
      "customer": {
        "data": {
          "type": "customer",
          "id": "10002"
        }
      },
      "payment": {
        "data": {
          "type": "payment",
          "id": "1"
        }
      },
      "recurringRepayment": {
        "data": {
          "type": "recurringRepayment",
          "id": "4"
        }
      }
    }
  }
}

Create Capital Partner ACH Repayment

Creates a repayment for a credit account. Both repayment.created and payment.created events are raised when the call is successful.

Capital Partner Repayment creation requests support Idempotency, ensuring that performing multiple identical requests will have the same effect as performing a single request.

Verb	`POST`
Url	`https://api.s.unit.sh/repayments`
Required Scope	`repayments-write` or `payments-write`
Data Type	`repayment`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
description	string	Payment description (maximum of 10 characters), also known as Company Entry Description, this will show up on statement of the counterparty.
amount	Integer (Cents)	The amount to repay.
addenda	string	Optional, additional payment description (maximum of 80 characters), not all institutions present that.
tags	object	Optional. See Tags.
sameDay	boolean	Optional, default is `false`. See Same Day ACH.
secCode	string	Optional. See Use a custom SEC Code.
idempotencyKey	string	Optional. See Idempotency.

Relationships

Name	Type	Description
creditAccount	JSON:API Relationship	The Credit Account that the repayment is made against.
counterparty	JSON:API Relationship	The ACH Counterparty the repayment will come from.

Example Request:
curl -X POST 'https://api.s.unit.sh/repayments'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "capitalPartnerAchRepayment",
    "attributes": {
      "amount": 200,
      "description": "test"
    },
    "relationships": {
      "creditAccount": {
        "data": {
          "type": "creditAccount",
          "id": "10082"
        }
      },
      "counterparty": {
        "data": {
          "type": "counterparty",
          "id": "3"
        }
      }
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Field	Type	Description
data	CapitalPartnerAchRepayment	The requested resource after the operation was completed.

Example Response:
{
  "data": {
    "type": "capitalPartnerAchRepayment",
    "id": "1",
    "attributes": {
      "createdAt": "2022-09-19T09:02:13.343Z",
      "updatedAt": "2022-09-19T09:02:13.343Z",
      "amount": 200,
      "status": "Pending"
    },
    "relationships": {
      "org": {
        "data": {
          "type": "org",
          "id": "1"
        }
      },
      "counterparty": {
        "data": {
          "type": "counterparty",
          "id": "1"
        }
      },
      "creditAccount": {
        "data": {
          "type": "creditAccount",
          "id": "10007"
        }
      },
      "payment": {
        "data": {
          "type": "payment",
          "id": "1"
        }
      }
    }
  }
}

Create Capital Partner Book Repayment

Creates a repayment for a credit account.

Book Repayment creation requests support Idempotency, ensuring that performing multiple identical requests will have the same result as a single request.

Verb	`POST`
Url	`https://api.s.unit.sh/repayments`
Required Scope	`repayments-write` or `payments-write`
Data Type	`repayment`
Timeout (Seconds)	`5`

Attributes

Name	Type	Description
description	string	Repayment description (maximum of 80 characters), this will show up on statement of the counterparty.
amount	Integer	The amount (cents) to repay.
transactionSummaryOverride	string	If this field is populated, its contents will be returned as the bookTransaction’s summary field (maximum of 100 characters).
tags	object	Optional. See Tags.
idempotencyKey	string	Optional. See Idempotency.

Relationships

Name	Type	Description
creditAccount	JSON:API Relationship	The Credit Account that the repayment is made against.
counterpartyAccount	JSON:API Relationship	The Deposit Account the repayment funds are taken from.

Example Request:
curl -X POST 'https://api.s.unit.sh/repayments'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "capitalPartnerBookRepayment",
    "attributes": {
      "amount": 20,
      "description": "test",
      "transactionSummaryOverride": "override",
      "idempotencyKey": "3a1a33be-4e12-4603-9ed0-820922389fb8"
    },
    "relationships": {
      "creditAccount": {
        "data": {
          "type": "creditAccount",
          "id": "10007"
        }
      },
      "counterpartyAccount": {
        "data": {
          "type": "account",
          "id": "10008"
        }
      }
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Field	Type	Description
data	CapitalPartnerBookRepayment	The requested resource after the operation was completed.

Example Response:
{
  "data": {
    "type": "capitalPartnerBookRepayment",
    "id": "4",
    "attributes": {
      "createdAt": "2022-09-19T09:10:09.206Z",
      "updatedAt": "2022-09-19T09:10:09.206Z",
      "amount": 20,
      "status": "Sent"
    },
    "relationships": {
      "org": {
        "data": {
          "type": "org",
          "id": "1"
        }
      },
      "counterparty": {
        "data": {
          "type": "account",
          "id": "10008"
        }
      },
      "creditAccount": {
        "data": {
          "type": "creditAccount",
          "id": "10007"
        }
      },
      "customer": {
        "data": {
          "type": "customer",
          "id": "10002"
        }
      },
      "payment": {
        "data": {
          "type": "payment",
          "id": "5"
        }
      },
      "recurringRepayment": {
        "data": {
          "type": "recurringRepayment",
          "id": "4"
        }
      }
    }
  }
}

Get by Id

Get a repayment by id.

Verb	`GET`
Url	`https://api.s.unit.sh/repayments/{id}`
Required Scope	`repayments`
Timeout (Seconds)	`5`

Response

Response is a JSON:API document.

200 OK

Field	Type	Description
data	One of the following types (ACH Repayment or Book Repayment	Repayment resource.

curl -X GET 'https://api.s.unit.sh/repayments/100' \
-H "Authorization: Bearer ${TOKEN}"

List Repayments

List repayments resources. Filtering, paging and sorting can be applied.

Verb	`GET`
Url	`https://api.s.unit.sh/repayments`
Required Scope	`repayments`
Timeout (Seconds)	`5`

Query Parameters

Name	Type	Default	Description
page[limit]	integer	100	Optional. Maximum number of resources that will be returned. Maximum is 1000 resources. See Pagination.
page[offset]	integer	0	Optional. Number of resources to skip. See Pagination.
filter[accountId]	string	(empty)	Optional. Filters the results by the specified account id.
filter[creditAccountId]	string	(empty)	Optional. Filters the results by the specified credit account id.
filter[recurringRepaymentId]	string	(empty)	Optional. Filters the result according to the associated Recurring Repayment id
filter[customerId]	string	(empty)	Optional. Filters the results by the specified customer id.
filter[status][]	string	(empty)	Optional. Filter repayments by status (`Pending`, `PendingReview`, `Returned`, `Sent` or `Rejected`). Usage example: *filter[status][0]=Active
filter[type][]	string	(empty)	Optional. Filter repayments by Repayment type. such as (`AchRepayment`, `BookRepayment`). Usage example: filter[type][0]=AchRepayment&filter[type][1]=BookRepayment

curl -X GET 'https://api.s.unit.sh/repayments?page[limit]=20&page[offset]=10&filter[status]=Pending' \
-H "Authorization: Bearer ${TOKEN}"

Response

Response is a JSON:API document.

200 OK

Field	Type	Description
data	Array of Repayments (ACH Repayment, Book Repayment	Array of repayment resources.
meta	JSON object that contains pagination data	Pagination data includes offset, limit and total (total items).

Example Response:
{
  "data": [
    {
      "type": "achRepayment",
      "id": "1",
      "attributes": {
        "createdAt": "2022-09-19T09:02:13.343Z",
        "updatedAt": "2022-09-19T09:02:13.343Z",
        "amount": 200,
        "status": "Pending"
      },
      "relationships": {
        "org": {
          "data": {
            "type": "org",
            "id": "1"
          }
        },
        "account": {
          "data": {
            "type": "account",
            "id": "10003"
          }
        },
        "counterparty": {
          "data": {
            "type": "counterparty",
            "id": "1"
          }
        },
        "creditAccount": {
          "data": {
            "type": "creditAccount",
            "id": "10007"
          }
        },
        "customer": {
          "data": {
            "type": "customer",
            "id": "10002"
          }
        },
        "payment": {
          "data": {
            "type": "payment",
            "id": "1"
          }
        }
      }
    },
    {
      "type": "bookRepayment",
      "id": "2",
      "attributes": {
        "createdAt": "2022-09-19T09:06:52.566Z",
        "updatedAt": "2022-09-19T09:06:52.566Z",
        "amount": 20,
        "status": "Rejected"
      },
      "relationships": {
        "counterparty": {
          "data": {
            "type": "account",
            "id": "10003"
          }
        },
        "account": {
          "data": {
            "type": "account",
            "id": "10002"
          }
        },
        "creditAccount": {
          "data": {
            "type": "creditAccount",
            "id": "10002"
          }
        },
        "customer": {
          "data": {
            "type": "customer",
            "id": "10007"
          }
        },
        "org": {
          "data": {
            "type": "org",
            "id": "1"
          }
        },
        "payment": {
          "data": {
            "type": "payment",
            "id": "3"
          }
        }
      }
    },
    {
      "type": "bookRepayment",
      "id": "3",
      "attributes": {
        "createdAt": "2022-09-19T09:07:40.314Z",
        "updatedAt": "2022-09-19T09:07:40.314Z",
        "amount": 20,
        "status": "Rejected"
      },
      "relationships": {
        "counterparty": {
          "data": {
            "type": "account",
            "id": "10003"
          }
        },
        "account": {
          "data": {
            "type": "account",
            "id": "10002"
          }
        },
        "creditAccount": {
          "data": {
            "type": "creditAccount",
            "id": "10002"
          }
        },
        "customer": {
          "data": {
            "type": "customer",
            "id": "10007"
          }
        },
        "org": {
          "data": {
            "type": "org",
            "id": "1"
          }
        },
        "payment": {
          "data": {
            "type": "payment",
            "id": "4"
          }
        }
      }
    },
    {
      "type": "capitalPartnerAchRepayment",
      "id": "4",
      "attributes": {
        "createdAt": "2022-09-19T09:02:13.343Z",
        "updatedAt": "2022-09-19T09:02:13.343Z",
        "amount": 200,
        "status": "Pending"
      },
      "relationships": {
        "counterparty": {
          "data": {
            "type": "counterparty",
            "id": "1"
          }
        },
        "creditAccount": {
          "data": {
            "type": "creditAccount",
            "id": "10007"
          }
        },
        "org": {
          "data": {
            "type": "org",
            "id": "1"
          }
        },
        "customer": {
          "data": {
            "type": "customer",
            "id": "10002"
          }
        },
        "payment": {
          "data": {
            "type": "payment",
            "id": "1"
          }
        }
      }
    }
  ],
  "meta": {
    "pagination": {
      "total": 3,
      "limit": 100,
      "offset": 0
    }
  }
}

Repayments

Capital Partner Repayments​

Repayment Statuses​

Book Repayment Statuses​

ACH Repayment Statuses​

Create Book Repayment​

Attributes​

Relationships​

Response​

201 Created​

Create ACH Repayment​

Attributes​

Relationships​

Response​

201 Created​

Create Capital Partner ACH Repayment​

Attributes​

Relationships​

Response​

201 Created​

Create Capital Partner Book Repayment​

Attributes​

Relationships​

Response​

201 Created​

Get by Id​

Response​

200 OK​

List Repayments​

Query Parameters​

Response​

200 OK​

Capital Partner Repayments

Repayment Statuses

Book Repayment Statuses

ACH Repayment Statuses

Create Book Repayment

Attributes

Relationships

Response

201 Created

Create ACH Repayment

Attributes

Relationships

Response

201 Created

Create Capital Partner ACH Repayment

Attributes

Relationships

Response

201 Created

Create Capital Partner Book Repayment

Attributes

Relationships

Response

201 Created

Get by Id

Response

200 OK

List Repayments

Query Parameters

Response

200 OK