Execute a payment attempt for a specific account

post

https://Contact sales to enable your sandbox/accounts/{account_id}/line_items/payments/payment_transfer

Canopy will first try to execute a payment via the account or payment's payment processor configuration, and then store the corresponding record in Canopy's system.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

account_id

string

required

ID of the Account

Body Params

Body of request to create payment.

line_item_id

string

The ID to be associated with the line item for future requests.

original_amount_cents

integer

required

Defaults to 0

The payment amount in cents.

line_item_status

string

enum

Defaults to VALID

The new status which you would like to set for the line item

Allowed:

effective_at

date-time

The Date-Time that the payment is applicable to the account. This field should only be used to back-date payment transactions for the purpose of testing or if a data migration is being performed with migration_mode enabled.

allocation

string | null

enum

Optional designation for which balance bucket the payment should be allocated to.

PRINCIPAL_PREPAYMENT_INSTALLMENT_END_TO_START allocation type is used to signal intent, and is not a guarantee that the payment will pour directly into principal. The principal to be poured into is selected from the last cycle of the loan backward. If the payment cannot be allocated as specified will apply to the account following configured payment pouring ordering.

Allowed:

allocation_line_item_id

string

If included, this payment will attempt to pay down the referenced Line Item first, prior to any other balances on the account. Note: this payment will pay down all Line Items which have a root_id equal to this value, meaning e.g. installment interest and amortized fees related to a loan will be paid down by referencing the Loan's Line Item ID.

external_fields

array,null | object,null

Responses

401

Unauthorized.

403

Forbidden.

422

Invalid input

429

Too many requests.

default

Unexpected Error.

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Payment created