Skip to main content

Create a payment

Creates a new payment to the specified account. Payments are transmitted electronically from a source account to a destination account. Payments are posted to the destination account (settled) in 1-2 business days. Verify the payment cutoff times for precise settlement times.
💡 Important: Only ach accounts can be used as a payment source. Destination accounts can be both ach and liability.

Parameters

amount

number
The amount of the payment to be created in cents. (e.g. $1.00 = 100)

Required

source

string
The id of an ach account from which the payment amount will be retrieved.

Required

destination

string
The id of an ach or liability account to which the payment amount will be sent.

Required

description

string
The payment's description (maximum of 10 characters).

Required

fee

object
Payment fee information. See payment fee.

Optional

Returns

Returns a payment object. The payment will be sent based on the cutoff times. The status of the payment will be updated when the payment is sent to our banking networks.

POST /payments
curl https://production.methodfi.com/payments \
  -X POST \
  -H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "source": "acc_JMJZT6r7iHi8e",
    "destination": "acc_AXthnzpBnxxWP",
    "description": "Loan Pmt"
  }'
RESPONSE
{
  "id": "pmt_rPrDPEwyCVUcm",
  "reversal_id": null,
  "source_trace_id": null,
  "destination_trace_id": null,
  "source": "acc_JMJZT6r7iHi8e",
  "destination": "acc_AXthnzpBnxxWP",
  "amount": 5000,
  "description": "Loan Pmt",
  "status": "pending",
  "error": null,
  "metadata": null,
  "estimated_completion_date": "2020-12-11",
  "source_settlement_date": "2020-12-09",
  "destination_settlement_date": "2020-12-11",
  "fee": null,
  "created_at": "2020-12-09T00:42:31.209Z",
  "updated_at": "2020-12-09T00:43:30.996Z"
}