---
title: "Create Payment Transaction"
method: POST
path: "/api/v1/payment/request"
tags: ["Payment", "Payment API"]
---

# Create Payment Transaction

`POST /api/v1/payment/request`

## Request

- The document declares no server URL.
- Auth: API key in header `client_id` and API key in header `client_secret`

## Request body

- object
  - `transaction_details` object, required
    - `ref_id` string, required: reference id example : INV202324000343
  - `total_amount` object, required
    - `payment_amount` number, double: Payment Amount
    - `supplier_fee` number, double: Supplier Fee
    - `buyer_fee` number, double: Buyer Fee
  - `partner` object, required
    - `partner_id` string
    - `partner_number` string, required: Partner Number
    - `company_name` string: Company Name
    - `company_email` string: Company Email
    - `company_phone` string
  - `destination` object
    - `bank_id` string
  - `reference_note` string
  - `invoices` object[]
    - `invoice_id` string
    - `invoice_number` string, required
    - `invoice_date` string, required
    - `invoice_due_date` string, required
    - `amount` number, double
    - `delivery_fee` number, double
    - `discount` number, double
    - `invoice_items` object[]
      - `name` string
      - `code` string
      - `description` string
      - `quantity` number, double
      - `uom_code` string
      - `price` number, double
      - `discount` number, double
      - `tax` number, double
      - `additional_info` unknown
  - `payment_method` object, required
    - `method` string, required
    - `channel` string, required
    - `amount` number, double
    - `name` string
    - `is_closed` boolean
    - `expiration_date` string
    - `expiration_duration` integer
    - `phone` string
  - `redirect_url` string
  - `send` object
    - `email` boolean
    - `whatsapp` boolean
    - `sms` boolean
  - `additional_info` unknown
  - `instant_payment` boolean

## Response `200`

Successful operation

- object
  - `status_code` integer, required
  - `message` string
  - `data` PaymentRequestData, required
    - `amount` number, double, required
    - `buyer_fee` number, double, required
    - `external_id` string, required
    - `merchant_fee` number, double, required
    - `payment_channel` string, required
    - `payment_id` string, required
    - `payment_method` string, required
    - `ref_id` string, required
  - `links` PaymentRequestLink[]
    - `rel` string
    - `href` string
    - `type` string
    - `kind` string

## Other responses

- `400`: Bad request
- `default`: Unsuccessful operation

---

[API](https://skmtc.dev/paper/apis/paper-open-api.md) - [All operations](https://skmtc.dev/paper/apis/paper-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paper/apis/paper-open-api/revisions/243ba6121589?raw)