---
title: "Create Payment"
method: POST
path: "/createPayment"
tags: ["Transactions"]
---

# Create Payment

`POST /createPayment`

Use the Create Payment endpoint to move funds into a customer account. This endpoint may return load limit and velocity violations in its response. Payments created with this endpoint are returned by the <a href="ref:post_getaccountoverview" target="_blank">Get Account Overview</a> endpoint only after several seconds have elapsed.

#### Load limit and velocity response
If the payment violates load or velocity limits, this endpoint returns `status: 26` with `limit_error`, `limit_id`, and `limit_response_code` values. Use the `limit_id` for  troubleshooting the load and velocity configuration. The `limit_response_code` values are enumerated in the <a href="ref:api-reference-limit-response-codes" target="_blank">Limit Response Codes</a> table.

Consult the <a href="doc:creating-a-payment" target="_blank">Creating a Payment</a> guide for instructions on using this endpoint.

## Response `default`

- object
  - `status_code` integer, nullable, required — The response status code. May return a string for some statuses.
  - `status` string, nullable, required — The condition of a process or response
  - `processing_time` number, float, nullable, required — The time elapsed in processing the transaction
  - `echo` object, nullable, required — A structure that contains transaction ID information
    - `transaction_id` string, nullable, required — An ID that represents an API transaction
    - `provider_timestamp` string, date-time, nullable, required — Store a related timestamp for reporting and troubleshooting purposes
    - `provider_transaction_id` string, nullable, required — Secondary transaction identifier (generated by a provider)
  - `system_timestamp` string, date-time, nullable, required — A system generated timestamp
  - `rtoken` string, nullable, required — A system-generated ID used for tracking
  - `errors` string[], nullable
  - `response_data` object, nullable, required — A structure for the response data. It can be empty but usually will contain information.
    - `old_balance` number, required — The balance on the account before the transaction
    - `new_balance` number, required — The balance on the account after the transaction
    - `fee_amount` string, required — Payment fee amount. May return an integer if the fee amount is 0.
    - `payment_trans_id` integer, required — System-generated payment ID, also called the `pmt_id`.
    - `transaction_id` string, required — Echo of the `transactionId` passed in the endpoint request.
    - `hold_id` integer, required — Identifier for the hold. Use the <a href="ref:post_expirehold" target="_blank">Expire Hold</a> endpoint to expire the hold before the time in `holdExpirationDateTime`.

---

[API](https://skmtc.net/galileo-ft/apis/program-api.md) · [All operations](https://skmtc.net/galileo-ft/apis/program-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo-ft/program-api/versions/bcd728f97a18/schema)