---
title: "Initiate vendor payment"
method: POST
path: "/vendor-payments"
tags: ["Vendor Payments"]
---

# Initiate vendor payment

`POST /vendor-payments`

Initiate payment for one or more bills. Bills must have pay_date set (422 if null).

## Request body

- CreateVendorPaymentInput — Vendor payment creation request
  - `idempotency_key` string
  - `items` PaymentItemInput[]
    - `bill_id` string
    - `payment_method_id` string
    - `payment_speed` 'standard' | 'next_day' | 'same_day' | 'instant' — Payment speed enum: standard, next_day, same_day, instant

## Response `200`

OK

- CreateVendorPaymentReply — Vendor payment creation results
  - `results` CreateVendorPaymentResultReply[]
    - `bill_id` string
    - `success` boolean

## Other responses

- `400` — Bad Request
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/alternativepayments/apis/alternative-payments.md) · [All operations](https://skmtc.net/alternativepayments/apis/alternative-payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alternativepayments/alternative-payments/revisions/730efda86cd1/schema)