---
title: "Submit a loan payment"
method: POST
path: "/payments"
tags: ["Payments"]
---

# Submit a loan payment

`POST /payments`

## Request

- Base URL: `https://production.pier-finance.com/api`
- URL: `https://production.pier-finance.com/api/payments`
- Auth: HTTP bearer

Instructs Pier to initiate an ACH payment for a loan. If repayment_ach_enabled is false, use none for transfer_type.

## Request body

- PaymentRequest
  - `facility_id` string, required: The facility_id of the credit facility to make a payment for
  - `amount` integer, required: The amount of the payment, in cents
  - `transfer_type` 'standard' | 'none', required: These transfer types are passed in by API users to indicate ACH or not.
  - `settlement_priority` 'standard' | 'next_day' | 'same_day': This determines the network speed used for ACH transfers.
  - `ach_authorization_id` string, nullable: The Document ID of an unused ACH authorization document (only required when `transfer_type` is not `none`)

## Response `200`

- Payment
  - `id` string, required
  - `amount` integer, required: The amount of the payment, in cents
  - `facility_id` string, required: The facility_id of the credit facility to make a payment for
  - `status` 'pending' | 'processing' | 'processed' | 'settled' | 'failed' | 'canceled' | 'cancellation_pending', required
  - `transfer_type` 'standard' | 'none' | 'refund' | 'credit' | 'cancellation' | 'suspense_credit', required: Transfer types that are not standard/none are set by special operations like the refund endpoint for example. Special types, like refund, will reference the original transaction transfer type of standard/none to determine if ACH was used if this knowledge is needed (e.g. does an ACH refund need to happen or was this ledgering only).
  - `created_on` string, date-time, required: Timestamp the payment is created on
  - `failure_reason` string, nullable: A reason for the failure if one exists
  - `is_autopay` boolean, nullable: If the payment was a result of an autopay

## Other responses

- `400`
- `401`
- `404`
- `429`
- `500`

---

[API](https://skmtc.dev/pier-finance/apis/pier-api.md) - [All operations](https://skmtc.dev/pier-finance/apis/pier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pier-finance/apis/pier-api/revisions/08a7c49252b9?raw)