v12

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-011518127.5 KB
payments

post/checkout-router/

Request body

namestring required

The first name of the client.

last_namestring required

The last name of the client.

email_clientstring email required

The email address of the client.

phone_numberstring required

The phone number of the client.

return_urlstring uri required

The URL to which the user will be redirected after completing the transaction.

id_productstring required

The identifier for the product.

quantity_productinteger required

The quantity of the product in the transaction.

id_shipstring required

The identifier for the shipping information.

instance_id_shipstring required

The instance identifier for the shipping information.

amountinteger required

The total monetary value of the transaction.

title_shipstring required

The title or type of shipping.

descriptionstring required

A description of the transaction.

device_session_idstring required

The identifier for the device session.

token_idstring

A token identifier associated with the transaction.

order_idinteger required

An identifier or reference number for the order.

business_idinteger required

The identifier for the business.

payment_idinteger required

The identifier for the payment.

sourcestring required

The source of the transaction.

Example request

{
  "card": {
    "cvv": "69f4d206-ceb6-4be8-82d8-7a39dceb9f87",
    "skyflow_id": "702faf3c-26f9-41c1-a287-cec20aa43929",
    "card_number": "9230-0892-4469-1474",
    "cardholder_name": "3b5d70a9-01b9-4001-8328-9b10168bac25",
    "expiration_year": "645a3174-340a-4849-ba5c-c4333d2967c9",
    "expiration_month": "5c6bef6c-9642-4403-9ce6-215b0d3f85b0"
  },
  "name": "Jhon",
  "last_name": "Doe",
  "email_client": "pruebas@sdk.com",
  "phone_number": "6181234567",
  "return_url": "http://tonder.io",
  "id_product": "no_id",
  "quantity_product": 1,
  "id_ship": "0",
  "instance_id_ship": "0",
  "amount": 1200,
  "title_ship": "shipping",
  "description": "transaction",
  "device_session_id": "VXJLx0H4Fxyz09Ssfbbv0QE8JXDjnKiW",
  "order_id": 5730,
  "business_id": 89,
  "payment_id": 5744,
  "source": "sdk"
}

Response

Successful response

statusstring

The HTTP status code indicating the success or failure of the response.

messagestring

A message providing additional information about the success or failure of the response.

transaction_statusstring

The status of the transaction, e.g., 'Success'.

transaction_idinteger

The unique identifier for the transaction.

payment_idinteger

The unique identifier for the payment associated with the transaction.

providerstring

The payment provider used for the transaction, e.g., 'stripe'.

next_actionobject

Details about the next action required for the transaction. If not applicable, an empty object is provided.

Example response

{
  "status": "200",
  "message": "Success",
  "psp_response": {
    "id": "ch_3OZyPSK5zRUzLwaW0CyXUIVQ",
    "object": "charge",
    "amount": 120000,
    "amount_captured": 120000,
    "balance_transaction": "txn_3OZyPSK5zRUzLwaW0iZIaxjx",
    "calculated_statement_descriptor": "GOLFMANAGER.COM",
    "captured": true,
    "created": 1705595142,
    "currency": "mxn",
    "customer": "cus_PBoeaxFGw6mZFF",
    "description": "transaction",
    "fraud_details": {},
    "metadata": {},
    "outcome": {
      "network_status": "approved_by_network",
      "risk_level": "normal",
      "risk_score": 15,
      "seller_message": "Payment complete.",
      "type": "authorized"
    },
    "paid": true,
    "payment_intent": "pi_3OZyPSK5zRUzLwaW0xfmGAjx",
    "payment_method": "pm_1OZyPRK5zRUzLwaWC5WKIOJC",
    "payment_method_details": {
      "card": {
        "amount_authorized": 120000,
        "brand": "visa",
        "country": "US",
        "exp_month": 11,
        "exp_year": 2025,
        "extended_authorization": {
          "status": "disabled"
        },
        "fingerprint": "g8tpcAz042MueZFZ",
        "funding": "credit",
        "incremental_authorization": {
          "status": "unavailable"
        },
        "last4": "4242",
        "multicapture": {
          "status": "unavailable"
        },
        "network": "visa",
        "overcapture": {
          "maximum_amount_capturable": 120000,
          "status": "unavailable"
        }
      },
      "type": "card"
    },
    "radar_options": {},
    "receipt_url": "https://pay.stripe.com/receipts/payment/CAcaFwoVYWNjdF8xREl5WTRLNXpSVXpMd2FXKIeipa0GMgbREzVbrVQ6LBZdZFnB8ZFMPXXaJlPrlgymIpkqBm3-pd3x-lnhgqwlKAC3AWrN3kEYGDep",
    "shipping": {
      "street": "N/a",
      "number": "N/a",
      "suburb": "N/a",
      "city": {
        "name": "N/a"
      },
      "state": {
        "name": "N/a",
        "country": {
          "name": "N/a"
        }
      },
      "zip_code": "N/a"
    },
    "status": "succeeded"
  },
  "transaction_status": "Success",
  "transaction_id": 11044,
  "payment_id": 5744,
  "provider": "stripe",
  "next_action": {},
  "actions": [
    {
      "name": "verify_transaction_status",
      "url": "/api/v1/stripe/business/89/payments/5744/transactions/11044",
      "method": "GET"
    },
    {
      "name": "refund_transaction",
      "url": "/api/v1/stripe/business/89/payments/ch_3OZyPSK5zRUzLwaW0CyXUIVQ/refunds",
      "method": "POST"
    }
  ]
}