Create Checkout Router

POST

checkout-router

curl --request POST \
  --url https://stage.tonder.io/api/v1/checkout-router/ \
  --header 'Content-Type: application/json' \
  --data '{
  "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",
  "token_id": "",
  "order_id": 5730,
  "business_id": 89,
  "payment_id": 5744,
  "source": "sdk"
}'

{
  "status": "200",
  "message": "Success",
  "psp_response": {
    "id": "ch_3OZyPSK5zRUzLwaW0CyXUIVQ",
    "object": "charge",
    "amount": 120000,
    "amount_captured": 120000,
    "amount_refunded": 0,
    "application": null,
    "application_fee": null,
    "application_fee_amount": null,
    "balance_transaction": "txn_3OZyPSK5zRUzLwaW0iZIaxjx",
    "billing_details": {
      "address": {
        "city": null,
        "country": null,
        "line1": null,
        "line2": null,
        "postal_code": null,
        "state": null
      },
      "email": null,
      "name": null,
      "phone": null
    },
    "calculated_statement_descriptor": "GOLFMANAGER.COM",
    "captured": true,
    "created": 1705595142,
    "currency": "mxn",
    "customer": "cus_PBoeaxFGw6mZFF",
    "description": "transaction",
    "destination": null,
    "dispute": null,
    "disputed": false,
    "failure_balance_transaction": null,
    "failure_code": null,
    "failure_message": null,
    "fraud_details": {},
    "invoice": null,
    "livemode": false,
    "metadata": {},
    "on_behalf_of": null,
    "order": null,
    "outcome": {
      "network_status": "approved_by_network",
      "reason": null,
      "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",
        "checks": {
          "address_line1_check": null,
          "address_postal_code_check": null,
          "cvc_check": null
        },
        "country": "US",
        "exp_month": 11,
        "exp_year": 2025,
        "extended_authorization": {
          "status": "disabled"
        },
        "fingerprint": "g8tpcAz042MueZFZ",
        "funding": "credit",
        "incremental_authorization": {
          "status": "unavailable"
        },
        "installments": null,
        "last4": "4242",
        "mandate": null,
        "multicapture": {
          "status": "unavailable"
        },
        "network": "visa",
        "network_token": {
          "used": false
        },
        "overcapture": {
          "maximum_amount_capturable": 120000,
          "status": "unavailable"
        },
        "three_d_secure": null,
        "wallet": null
      },
      "type": "card"
    },
    "radar_options": {},
    "receipt_email": null,
    "receipt_number": null,
    "receipt_url": "https://pay.stripe.com/receipts/payment/CAcaFwoVYWNjdF8xREl5WTRLNXpSVXpMd2FXKIeipa0GMgbREzVbrVQ6LBZdZFnB8ZFMPXXaJlPrlgymIpkqBm3-pd3x-lnhgqwlKAC3AWrN3kEYGDep",
    "refunded": false,
    "review": null,
    "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"
    },
    "source": null,
    "source_transfer": null,
    "statement_descriptor": null,
    "statement_descriptor_suffix": null,
    "status": "succeeded",
    "transfer_data": null,
    "transfer_group": null
  },
  "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"
    }
  ]
}

The Authorization needs to be in the following format:

Authorization: Token <YOUR_API_KEY>

Body

application/json

card

object

required

Contains information related to the payment card used in the transaction.

name

string

required

The first name of the client.

Example:

"Jhon"

last_name

string

required

The last name of the client.

Example:

"Doe"

email_client

string

required

The email address of the client.

Example:

"pruebas@sdk.com"

phone_number

string

required

The phone number of the client.

Example:

"6181234567"

return_url

string

required

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

Example:

"http://tonder.io"

id_product

string

required

The identifier for the product.

Example:

"no_id"

quantity_product

integer

required

The quantity of the product in the transaction.

Example:

1

id_ship

string

required

The identifier for the shipping information.

Example:

"0"

instance_id_ship

string

required

The instance identifier for the shipping information.

Example:

"0"

amount

integer

required

The total monetary value of the transaction.

Example:

1200

title_ship

string

required

The title or type of shipping.

Example:

"shipping"

description

string

required

A description of the transaction.

Example:

"transaction"

device_session_id

string

required

The identifier for the device session.

Example:

"VXJLx0H4Fxyz09Ssfbbv0QE8JXDjnKiW"

order_id

integer

required

An identifier or reference number for the order.

Example:

5730

business_id

integer

required

The identifier for the business.

Example:

89

payment_id

integer

required

The identifier for the payment.

Example:

5744

source

string

required

The source of the transaction.

Example:

"sdk"

token_id

string

A token identifier associated with the transaction.

Example:

""

Response

201

application/json

Successful response

status

string

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

Example:

"200"

message

string

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

Example:

"Success"

psp_response

object

The response from the payment service provider (PSP) containing detailed information about the payment transaction.

psp_response.id

string

A unique identifier for the payment transaction within the payment service provider (PSP) system.

Example:

"ch_3OZyPSK5zRUzLwaW0CyXUIVQ"

psp_response.object

string

The type of object, representing the nature of the transaction (e.g., 'charge' for a payment charge).

Example:

"charge"

psp_response.amount

integer

The total amount of the transaction, expressed in the smallest currency unit (e.g., cents or pence).

Example:

120000

psp_response.amount_captured

integer

The amount that has been captured or collected from the customer as part of the transaction.

Example:

120000

psp_response.amount_refunded

integer

The amount that has been refunded to the customer as part of the transaction.

Example:

0

psp_response.application

string

The identifier of the application associated with the transaction, if applicable.

Example:

null

psp_response.application_fee

string

The application fee, if any, applied to the transaction.

Example:

null

psp_response.application_fee_amount

string

The amount of the application fee, if any, applied to the transaction.

Example:

null

psp_response.balance_transaction

string

The identifier of the balance transaction associated with the payment charge.

Example:

"txn_3OZyPSK5zRUzLwaW0iZIaxjx"

psp_response.billing_details

object

Object containing details about the billing information.

psp_response.calculated_statement_descriptor

string

The calculated statement descriptor associated with the transaction.

Example:

"GOLFMANAGER.COM"

psp_response.captured

boolean

Indicates whether the payment has been captured (true) or not (false).

Example:

true

psp_response.created

integer

The timestamp representing the creation date and time of the transaction.

Example:

1705595142

psp_response.currency

string

The currency code associated with the transaction.

Example:

"mxn"

psp_response.customer

string

The identifier of the customer associated with the transaction.

Example:

"cus_PBoeaxFGw6mZFF"

psp_response.description

string

A description or additional information about the transaction.

Example:

"transaction"

psp_response.destination

string

The destination of the transaction, if applicable.

Example:

null

psp_response.dispute

string

The identifier of any dispute associated with the transaction, if applicable.

Example:

null

psp_response.disputed

boolean

Indicates whether the transaction is disputed (true) or not (false).

Example:

false

psp_response.failure_balance_transaction

string

The identifier of the balance transaction in case of failure, if applicable.

Example:

null

psp_response.failure_code

string

The code associated with the failure, if applicable.

Example:

null

psp_response.failure_message

string

A message providing details about the failure, if applicable.

Example:

null

psp_response.fraud_details

object

Details about any fraud associated with the transaction, if applicable.

Example:

{}

psp_response.invoice

string

The identifier of the invoice associated with the transaction, if applicable.

Example:

null

psp_response.livemode

boolean

Indicates whether the transaction was created in live mode (true) or test mode (false).

Example:

false

psp_response.metadata

object

Additional metadata associated with the transaction.

Example:

{}

psp_response.on_behalf_of

string

The identifier of the account on behalf of which the transaction is performed, if applicable.

Example:

null

psp_response.order

string

The identifier of the order associated with the transaction, if applicable.

Example:

null

psp_response.outcome

object

Details about the outcome of the payment transaction.

psp_response.paid

boolean

A boolean indicating whether the payment has been successfully paid.

Example:

true

psp_response.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.

Example:

"pi_3OZyPSK5zRUzLwaW0xfmGAjx"

psp_response.payment_method

string

The unique identifier of the payment method used for this transaction, such as a credit card or debit card.

Example:

"pm_1OZyPRK5zRUzLwaWC5WKIOJC"

psp_response.payment_method_details

object

Details about the payment method used for the transaction, including card details and type.

psp_response.payment_method_details.card

object

Details about the card used for the payment, including brand, checks, country, expiration, and more.

psp_response.payment_method_details.card.amount_authorized

integer

The amount authorized on the card, represented as an integer value.

Example:

120000

psp_response.payment_method_details.card.brand

string

The brand or type of the card used for the payment (e.g., Visa, MasterCard).

Example:

"visa"

psp_response.payment_method_details.card.checks

object

Various checks performed on the card details for validation purposes.

psp_response.payment_method_details.card.country

string

The country where the card was issued.

Example:

"US"

psp_response.payment_method_details.card.exp_month

integer

The expiration month of the card.

Example:

11

psp_response.payment_method_details.card.exp_year

integer

The expiration year of the card.

Example:

2025

psp_response.payment_method_details.card.extended_authorization

object

Information about extended authorization status.

psp_response.payment_method_details.card.fingerprint

string

A unique identifier (fingerprint) for the card.

Example:

"g8tpcAz042MueZFZ"

psp_response.payment_method_details.card.funding

string

The funding source of the card, such as 'credit'.

Example:

"credit"

psp_response.payment_method_details.card.incremental_authorization

object

Information about incremental authorization status.

psp_response.payment_method_details.card.installments

string

The number of installments for the payment, if applicable.

Example:

null

psp_response.payment_method_details.card.last4

string

The last four digits of the card number.

Example:

"4242"

psp_response.payment_method_details.card.mandate

string

The mandate associated with the payment, if applicable.

Example:

null

psp_response.payment_method_details.card.multicapture

object

Information about multicapture status.

psp_response.payment_method_details.card.network

string

The card network, such as Visa.

Example:

"visa"

psp_response.payment_method_details.card.network_token

object

Information about the usage status of the network token.

psp_response.payment_method_details.card.overcapture

object

Information about overcapture status.

psp_response.payment_method_details.card.three_d_secure

string

The status of 3D Secure authentication, if applicable.

Example:

null

psp_response.payment_method_details.card.wallet

string

The type of wallet used for the payment, if applicable.

Example:

null

psp_response.payment_method_details.type

string

The type of payment method, such as 'card'.

Example:

"card"

psp_response.radar_options

object

Options related to Stripe Radar, which provides advanced fraud protection.

Example:

{}

psp_response.receipt_email

string

The email address to which the receipt for the transaction was sent, or null if no receipt was sent.

Example:

null

psp_response.receipt_number

string

The receipt number associated with the transaction, or null if no receipt number is available.

Example:

null

psp_response.receipt_url

string

The URL to view the receipt for the payment, or null if no receipt is available.

Example:

"https://pay.stripe.com/receipts/payment/CAcaFwoVYWNjdF8xREl5WTRLNXpSVXpMd2FXKIeipa0GMgbREzVbrVQ6LBZdZFnB8ZFMPXXaJlPrlgymIpkqBm3-pd3x-lnhgqwlKAC3AWrN3kEYGDep"

psp_response.refunded

boolean

A boolean indicating whether the payment has been refunded.

Example:

false

psp_response.review

string

The status of the payment review, or null if no review is in progress.

Example:

null

psp_response.shipping

object

Information about the shipping address associated with the transaction.

psp_response.source

string

The ID of the payment source. If not applicable or available, set to null.

Example:

null

psp_response.source_transfer

string

The ID of the transfer made from the payment source. If not applicable or available, set to null.

Example:

null

psp_response.statement_descriptor

string

A custom statement descriptor for the payment. If not applicable or available, set to null.

Example:

null

psp_response.statement_descriptor_suffix

string

A custom statement descriptor suffix for the payment. If not applicable or available, set to null.

Example:

null

psp_response.status

string

The status of the payment transaction, e.g., 'succeeded'.

Example:

"succeeded"

psp_response.transfer_data

string

Information about the transfer associated with the payment. If not applicable or available, set to null.

Example:

null

psp_response.transfer_group

string

The ID of the transfer group. If not applicable or available, set to null.

Example:

null

transaction_status

string

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

Example:

"Success"

transaction_id

integer

The unique identifier for the transaction.

Example:

11044

payment_id

integer

The unique identifier for the payment associated with the transaction.

Example:

5744

provider

string

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

Example:

"stripe"

next_action

object

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

Example:

{}

actions

object[]

An array of actions that can be performed for the transaction, each represented by an object with 'name', 'url', and 'method' properties.

An array of actions associated with the transaction.

Example:

[
  {
    "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"
  }
]

Create Payment Create a Secure Token

curl --request POST \
  --url https://stage.tonder.io/api/v1/checkout-router/ \
  --header 'Content-Type: application/json' \
  --data '{
  "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",
  "token_id": "",
  "order_id": 5730,
  "business_id": 89,
  "payment_id": 5744,
  "source": "sdk"
}'

{
  "status": "200",
  "message": "Success",
  "psp_response": {
    "id": "ch_3OZyPSK5zRUzLwaW0CyXUIVQ",
    "object": "charge",
    "amount": 120000,
    "amount_captured": 120000,
    "amount_refunded": 0,
    "application": null,
    "application_fee": null,
    "application_fee_amount": null,
    "balance_transaction": "txn_3OZyPSK5zRUzLwaW0iZIaxjx",
    "billing_details": {
      "address": {
        "city": null,
        "country": null,
        "line1": null,
        "line2": null,
        "postal_code": null,
        "state": null
      },
      "email": null,
      "name": null,
      "phone": null
    },
    "calculated_statement_descriptor": "GOLFMANAGER.COM",
    "captured": true,
    "created": 1705595142,
    "currency": "mxn",
    "customer": "cus_PBoeaxFGw6mZFF",
    "description": "transaction",
    "destination": null,
    "dispute": null,
    "disputed": false,
    "failure_balance_transaction": null,
    "failure_code": null,
    "failure_message": null,
    "fraud_details": {},
    "invoice": null,
    "livemode": false,
    "metadata": {},
    "on_behalf_of": null,
    "order": null,
    "outcome": {
      "network_status": "approved_by_network",
      "reason": null,
      "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",
        "checks": {
          "address_line1_check": null,
          "address_postal_code_check": null,
          "cvc_check": null
        },
        "country": "US",
        "exp_month": 11,
        "exp_year": 2025,
        "extended_authorization": {
          "status": "disabled"
        },
        "fingerprint": "g8tpcAz042MueZFZ",
        "funding": "credit",
        "incremental_authorization": {
          "status": "unavailable"
        },
        "installments": null,
        "last4": "4242",
        "mandate": null,
        "multicapture": {
          "status": "unavailable"
        },
        "network": "visa",
        "network_token": {
          "used": false
        },
        "overcapture": {
          "maximum_amount_capturable": 120000,
          "status": "unavailable"
        },
        "three_d_secure": null,
        "wallet": null
      },
      "type": "card"
    },
    "radar_options": {},
    "receipt_email": null,
    "receipt_number": null,
    "receipt_url": "https://pay.stripe.com/receipts/payment/CAcaFwoVYWNjdF8xREl5WTRLNXpSVXpMd2FXKIeipa0GMgbREzVbrVQ6LBZdZFnB8ZFMPXXaJlPrlgymIpkqBm3-pd3x-lnhgqwlKAC3AWrN3kEYGDep",
    "refunded": false,
    "review": null,
    "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"
    },
    "source": null,
    "source_transfer": null,
    "statement_descriptor": null,
    "statement_descriptor_suffix": null,
    "status": "succeeded",
    "transfer_data": null,
    "transfer_group": null
  },
  "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"
    }
  ]
}

Tonder API

API Reference

Create Checkout Router

Body

Response