# Create Manual Payment

Create a manual payment

Endpoint: POST /v1/manual
Version: v1

## Request fields (application/json):

  - `token` (string, required)
    Payment token
    Example: "16RgvZ9XBTz4IUEIM0mD31f3808okqN2"

  - `merchant_id` (string, required)
    Unique identifier for the merchant
    Example: "merchant_02c7h71rf3eg396idngupsr66t"

  - `amount` (integer, required)
    Payment amount
    Example: 100

  - `tip` (integer, required)
    Tip amount
    Example: 1

  - `tax` (integer, required)
    Tax amount
    Example: 10

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier for the charge
    Example: "ch_01j8emz8chfxbb2bqmtref8ch7"

  - `merchant` (object, required)

  - `merchant.id` (string, required)
    Unique identifier for the merchant
    Example: "merchant_02c7h71rf3eg396idngupsr66t"

  - `merchant.gateway_merchant_id` (string)
    Unique identifier for the merchant in the payment gateway
    Example: "cs32cvc4i4783pdn9ml1"

  - `merchant.api_key` (string)
    Secret API key for the merchant
    Example: "api_2y46nIaf2xjtD0B74aZ6oxhQRxL"

  - `merchant.pub_api_key` (string)
    Public API key for the merchant
    Example: "pub_2y46nKsfnVmYQ7Fw6FTOhvS9l0F"

  - `merchant.processors` (array)
    Merchant processors

  - `merchant.processors.id` (string, required)
    Unique identifier for the processor
    Example: "cs32cvn0i4793pdn9mog"

  - `merchant.processors.processor_type` (string, required)
    Enum: "ACH", "CREDIT_CARD"

  - `payment_type` (string, required)
    Type of payment for the charge
    Example: "MANUAL"

  - `status` (string, required)
    status of the charge
    Enum: "AUTHORIZED", "SETTLED"

  - `requested_amount` (integer, required)
    Requested amount for the charge
    Example: 100

  - `amount_authorized` (integer, required)
    Amount authorized for the charge
    Example: 100

  - `amount_captured` (integer, required)
    Amount captured for the charge
    Example: 100

  - `tip` (integer, required)
    Tip amount for the charge
    Example: 1

  - `tax` (integer, required)
    Tax amount for the charge
    Example: 10

  - `card_last_4` (string)
    Last 4 digits of the card used for the charge
    Example: 1234

  - `card_brand` (string)
    Brand of the card used for the charge
    Example: "VISA"

  - `created_at` (integer, required)
    Timestamp when the charge was created
    Example: 1727875117482

  - `authorized_at` (integer)
    Timestamp when the charge was authorized
    Example: 1727875117482

  - `captured_at` (integer)
    Timestamp when the charge was captured
    Example: 1727875117482

  - `settled_at` (integer)
    Timestamp when the charge was settled
    Example: 1727875117482

  - `card_entry_method` (string, required)
    Method used for card entry
    Enum: "SWIPE", "CHIP", "MANUAL"

  - `billing_address` (object)
    Billing address details

  - `billing_address.company` (string)
    Company name associated with the address
    Example: "Acme Corp"

  - `billing_address.phone` (string, required)
    Phone number associated with the address
    Example: "+1234567890"

  - `billing_address.email` (string, required)
    Email address associated with the address
    Example: "example@domain.com"

  - `billing_address.first_name` (string)
    First name of the person associated with the address
    Example: "John"

  - `billing_address.last_name` (string)
    Last name of the person associated with the address
    Example: "Doe"

  - `billing_address.address_line_1` (string)
    First line of the address
    Example: 123

  - `billing_address.address_line_2` (string)
    Second line of the address
    Example: "Apt 4B"

  - `billing_address.city` (string)
    City of the address
    Example: "New York"

  - `billing_address.state` (string)
    State of the address
    Example: "NY"

  - `billing_address.postal_code` (string)
    Postal code of the address
    Example: 10001

  - `billing_address.country` (string)
    Country of the address
    Example: "USA"

  - `billing_address.fax` (string)
    Fax number associated with the address
    Example: "+1234567890"

  - `card_expiration_date` (string)
    Expiration date of the card
    Example: "01/27"

  - `card_type` (string)
    Type of the card
    Example: "debit"

  - `failure_reason` (string)
    Reason for the charge failure
    Example: "Card declined"

  - `refunds` (array)
    List of refunds associated with this charge

  - `refunds.id` (string, required)
    Unique identifier for the refund
    Example: "re_01j8emz8chfxbb2bqmtref8ch7"

  - `refunds.charge_id` (string, required)
    Unique identifier for the charge
    Example: "ch_01j8emz8chfxbb2bqmtref8ch7"

  - `refunds.merchant_id` (string, required)
    Unique identifier for the merchant
    Example: "merchant_02c7h71rf3eg396idngupsr66t"

  - `refunds.amount` (integer, required)
    Amount of the refund
    Example: 100

  - `refunds.created_at` (integer, required)
    Timestamp in milliseconds when the refund was created
    Example: 1727875117482