---
title: "POST /checkout-router/"
method: POST
path: "/checkout-router/"
tags: ["payments"]
---

# POST /checkout-router/

`POST /checkout-router/`

## Request body

- object
  - `card` object, required — Contains information related to the payment card used in the transaction.
    - `cvv` string, required — The Card Verification Value (CVV) associated with the card.
    - `skyflow_id` string, required — The unique identifier associated with the card in Skyflow's secure vault.
    - `card_number` string, required — The card number.
    - `cardholder_name` string, required — The name of the cardholder.
    - `expiration_year` string, required — The expiration year of the card.
    - `expiration_month` string, required — The expiration month of the card.
  - `name` string, required — The first name of the client.
  - `last_name` string, required — The last name of the client.
  - `email_client` string, email, required — The email address of the client.
  - `phone_number` string, required — The phone number of the client.
  - `return_url` string, uri, required — The URL to which the user will be redirected after completing the transaction.
  - `id_product` string, required — The identifier for the product.
  - `quantity_product` integer, required — The quantity of the product in the transaction.
  - `id_ship` string, required — The identifier for the shipping information.
  - `instance_id_ship` string, required — The instance identifier for the shipping information.
  - `amount` integer, required — The total monetary value of the transaction.
  - `title_ship` string, required — The title or type of shipping.
  - `description` string, required — A description of the transaction.
  - `device_session_id` string, required — The identifier for the device session.
  - `token_id` string — A token identifier associated with the transaction.
  - `order_id` integer, required — An identifier or reference number for the order.
  - `business_id` integer, required — The identifier for the business.
  - `payment_id` integer, required — The identifier for the payment.
  - `source` string, required — The source of the transaction.

## Response `201`

Successful response

- object
  - `status` string — The HTTP status code indicating the success or failure of the response.
  - `message` string — A message providing additional information about the success or failure of the response.
  - `psp_response` object — The response from the payment service provider (PSP) containing detailed information about the payment transaction.
    - `id` string — A unique identifier for the payment transaction within the payment service provider (PSP) system.
    - `object` string — The type of object, representing the nature of the transaction (e.g., 'charge' for a payment charge).
    - `amount` integer — The total amount of the transaction, expressed in the smallest currency unit (e.g., cents or pence).
    - `amount_captured` integer — The amount that has been captured or collected from the customer as part of the transaction.
    - `amount_refunded` integer — The amount that has been refunded to the customer as part of the transaction.
    - `application` string — The identifier of the application associated with the transaction, if applicable.
    - `application_fee` string — The application fee, if any, applied to the transaction.
    - `application_fee_amount` string — The amount of the application fee, if any, applied to the transaction.
    - `balance_transaction` string — The identifier of the balance transaction associated with the payment charge.
    - `billing_details` object — Object containing details about the billing information.
      - `address` object — Object containing details about the address in the billing details.
        - `city` string — The city associated with the billing address.
        - `country` string — The country associated with the billing address.
        - `line1` string — The first line of the billing address.
        - `line2` string — The second line of the billing address.
        - `postal_code` string — The postal code associated with the billing address.
        - `state` string — The state or region associated with the billing address.
      - `email` string — The email address associated with the billing details.
      - `name` string — The name associated with the billing details.
      - `phone` string — The phone number associated with the billing details.
    - `calculated_statement_descriptor` string — The calculated statement descriptor associated with the transaction.
    - `captured` boolean — Indicates whether the payment has been captured (true) or not (false).
    - `created` integer — The timestamp representing the creation date and time of the transaction.
    - `currency` string — The currency code associated with the transaction.
    - `customer` string — The identifier of the customer associated with the transaction.
    - `description` string — A description or additional information about the transaction.
    - `destination` string — The destination of the transaction, if applicable.
    - `dispute` string — The identifier of any dispute associated with the transaction, if applicable.
    - `disputed` boolean — Indicates whether the transaction is disputed (true) or not (false).
    - `failure_balance_transaction` string — The identifier of the balance transaction in case of failure, if applicable.
    - `failure_code` string — The code associated with the failure, if applicable.
    - `failure_message` string — A message providing details about the failure, if applicable.
    - `fraud_details` object — Details about any fraud associated with the transaction, if applicable.
    - `invoice` string — The identifier of the invoice associated with the transaction, if applicable.
    - `livemode` boolean — Indicates whether the transaction was created in live mode (true) or test mode (false).
    - `metadata` object — Additional metadata associated with the transaction.
    - `on_behalf_of` string — The identifier of the account on behalf of which the transaction is performed, if applicable.
    - `order` string — The identifier of the order associated with the transaction, if applicable.
    - `outcome` object — Details about the outcome of the payment transaction.
      - `network_status` string — The network status of the payment, indicating whether it was approved by the payment network.
      - `reason` string — The reason for the outcome, if available. For example, it might contain details if the payment was declined.
      - `risk_level` string — The risk level associated with the payment, indicating the perceived risk of the transaction.
      - `risk_score` integer — The numerical risk score assigned to the payment transaction, providing a quantitative measure of risk.
      - `seller_message` string — A message for the seller providing information about the outcome of the payment, typically for display purposes.
      - `type` string — The type of outcome, indicating the result of the payment authorization process (e.g., 'authorized', 'manual_review', 'issuer_declined').
    - `paid` boolean — A boolean indicating whether the payment has been successfully paid.
    - `payment_intent` string — The unique identifier of the payment intent associated with this payment transaction. This is relevant for payments using payment methods that involve a two-step confirmation process.
    - `payment_method` string — The unique identifier of the payment method used for this transaction, such as a credit card or debit card.
    - `payment_method_details` object — Details about the payment method used for the transaction, including card details and type.
      - `card` object — Details about the card used for the payment, including brand, checks, country, expiration, and more.
        - `amount_authorized` integer — The amount authorized on the card, represented as an integer value.
        - `brand` string — The brand or type of the card used for the payment (e.g., Visa, MasterCard).
        - `checks` object — Various checks performed on the card details for validation purposes.
          - `address_line1_check` string — The result of the address line 1 check, indicating if it matches the card's billing address.
          - `address_postal_code_check` string — The result of the postal code check, indicating if it matches the card's billing postal code.
          - `cvc_check` string — The result of the card security code (CVC) check.
        - `country` string — The country where the card was issued.
        - `exp_month` integer — The expiration month of the card.
        - `exp_year` integer — The expiration year of the card.
        - `extended_authorization` object — Information about extended authorization status.
          - `status` string — The status of extended authorization, indicating if it is enabled or disabled.
        - `fingerprint` string — A unique identifier (fingerprint) for the card.
        - `funding` string — The funding source of the card, such as 'credit'.
        - `incremental_authorization` object — Information about incremental authorization status.
          - `status` string — The status of incremental authorization, indicating if it is available or unavailable.
        - `installments` string — The number of installments for the payment, if applicable.
        - `last4` string — The last four digits of the card number.
        - `mandate` string — The mandate associated with the payment, if applicable.
        - `multicapture` object — Information about multicapture status.
          - `status` string — The status of multicapture, indicating if it is available or unavailable.
        - `network` string — The card network, such as Visa.
        - `network_token` object — Information about the usage status of the network token.
          - `used` boolean — A boolean indicating whether the network token has been used.
        - `overcapture` object — Information about overcapture status.
          - `maximum_amount_capturable` integer — The maximum amount that can be captured for the payment.
          - `status` string — The status of overcapture, indicating if it is available or unavailable.
        - `three_d_secure` string — The status of 3D Secure authentication, if applicable.
        - `wallet` string — The type of wallet used for the payment, if applicable.
      - `type` string — The type of payment method, such as 'card'.
    - `radar_options` object — Options related to Stripe Radar, which provides advanced fraud protection.
    - `receipt_email` string — The email address to which the receipt for the transaction was sent, or null if no receipt was sent.
    - `receipt_number` string — The receipt number associated with the transaction, or null if no receipt number is available.
    - `receipt_url` string — The URL to view the receipt for the payment, or null if no receipt is available.
    - `refunded` boolean — A boolean indicating whether the payment has been refunded.
    - `review` string — The status of the payment review, or null if no review is in progress.
    - `shipping` object — Information about the shipping address associated with the transaction.
      - `street` string — The street address for shipping. If not applicable, set to 'N/a'.
      - `number` string — The street number for shipping. If not applicable, set to 'N/a'.
      - `suburb` string — The suburb or neighborhood for shipping. If not applicable, set to 'N/a'.
      - `city` object — The city information for shipping.
        - `name` string — The name of the city for shipping. If not applicable, set to 'N/a'.
      - `state` object — The state information for shipping.
        - `name` string — The name of the state for shipping. If not applicable, set to 'N/a'.
        - `country` object — The country information for shipping.
          - `name` string — The name of the country for shipping. If not applicable, set to 'N/a'.
      - `zip_code` string — The ZIP code for shipping. If not applicable, set to 'N/a'.
    - `source` string — The ID of the payment source. If not applicable or available, set to null.
    - `source_transfer` string — The ID of the transfer made from the payment source. If not applicable or available, set to null.
    - `statement_descriptor` string — A custom statement descriptor for the payment. If not applicable or available, set to null.
    - `statement_descriptor_suffix` string — A custom statement descriptor suffix for the payment. If not applicable or available, set to null.
    - `status` string — The status of the payment transaction, e.g., 'succeeded'.
    - `transfer_data` string — Information about the transfer associated with the payment. If not applicable or available, set to null.
    - `transfer_group` string — The ID of the transfer group. If not applicable or available, set to null.
  - `transaction_status` string — The status of the transaction, e.g., 'Success'.
  - `transaction_id` integer — The unique identifier for the transaction.
  - `payment_id` integer — The unique identifier for the payment associated with the transaction.
  - `provider` string — The payment provider used for the transaction, e.g., 'stripe'.
  - `next_action` object — Details about the next action required for the transaction. If not applicable, an empty object is provided.
  - `actions` object[] — An array of actions that can be performed for the transaction, each represented by an object with 'name', 'url', and 'method' properties.
    - `name` string — The name of the action, e.g., 'verify_transaction_status'.
    - `url` string — The URL endpoint for the action.
    - `method` string — The HTTP method for the action, e.g., 'GET'.

## Other responses

- `403` — Forbidden

---

[API](https://skmtc.net/tonderio/apis/tonder.md) · [All operations](https://skmtc.net/tonderio/apis/tonder/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonderio/tonder/revisions/aface34fb9b2/schema)