# Create a new payment Request.

Create a payment on behalf of a merchant. Provide partner and merchant IDs and a unique partner payment ID for idempotency.

Endpoint: POST /finance/v1/payment_request
Security: Bearer

## Request fields (application/json):

  - `payeeId` (integer, required)
    (Required) ID of the payee created earlier.

  - `merchantAccountNumber` (string,null)

  - `amount` (integer, required)
    (Required) Amount to send. Must be greater than 0.

  - `currency` (string,null)
    (Optional) Currency code in ISO 4217 format. Default:USD

  - `paymentMethodType` (string, required)
    (Required) Payment method type
    Enum: "STANDARD", "SAME_DAY", "DOMESTIC_WIRE", "INTERNATIONAL_WIR"

  - `description` (string, required)
    (Required) Description of the payment (max 500 chars).

  - `externalId` (string,null)
    (Optional) External identifier if needed.

  - `internalNote` (string,null)
    (Optional) Internal note for the payment.

  - `partnerId` (integer,null, required)
    (Required) Partner ID assigned to your integration.

  - `merchantId` (integer,null, required)
    (Required) Merchant ID under which this payment is initiated.

  - `partnerPaymentUniqueId` (string,null)
    (Required) Unique partner payment identifier for idempotency.

## Response 200 fields (application/json):

  - `payeeId` (integer)

  - `amount` (number)

  - `currency` (string)

  - `paymentMethodType` (string)

  - `description` (string)

  - `partnerId` (integer)

  - `merchantId` (integer)

  - `partnerPaymentUniqueId` (string)