Create Checkout Router
Contains information related to the payment card used in the transaction.
The Card Verification Value (CVV) associated with the card.
The unique identifier associated with the card in Skyflow's secure vault.
The card number.
The name of the cardholder.
The expiration year of the card.
The expiration month of the card.
The first name of the client.
The last name of the client.
The email address of the client.
The phone number of the client.
The URL to which the user will be redirected after completing the transaction.
The identifier for the product.
The quantity of the product in the transaction.
The identifier for the shipping information.
The instance identifier for the shipping information.
The total monetary value of the transaction.
The title or type of shipping.
A description of the transaction.
The identifier for the device session.
A token identifier associated with the transaction.
An identifier or reference number for the order.
The identifier for the business.
The identifier for the payment.
The source of the transaction.
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": "<string>",
"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": 123,
"application": "<string>",
"application_fee": "<string>",
"application_fee_amount": "<string>",
"balance_transaction": "txn_3OZyPSK5zRUzLwaW0iZIaxjx",
"billing_details": {
"address": {
"city": "<string>",
"country": "<string>",
"line1": "<string>",
"line2": "<string>",
"postal_code": "<string>",
"state": "<string>"
},
"email": "<string>",
"name": "<string>",
"phone": "<string>"
},
"calculated_statement_descriptor": "GOLFMANAGER.COM",
"captured": true,
"created": 1705595142,
"currency": "mxn",
"customer": "cus_PBoeaxFGw6mZFF",
"description": "transaction",
"destination": "<string>",
"dispute": "<string>",
"disputed": true,
"failure_balance_transaction": "<string>",
"failure_code": "<string>",
"failure_message": "<string>",
"fraud_details": {},
"invoice": "<string>",
"livemode": true,
"metadata": {},
"on_behalf_of": "<string>",
"order": "<string>",
"outcome": {
"network_status": "approved_by_network",
"reason": "<string>",
"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": "<string>",
"address_postal_code_check": "<string>",
"cvc_check": "<string>"
},
"country": "US",
"exp_month": 11,
"exp_year": 2025,
"extended_authorization": {
"status": "disabled"
},
"fingerprint": "g8tpcAz042MueZFZ",
"funding": "credit",
"incremental_authorization": {
"status": "unavailable"
},
"installments": "<string>",
"last4": "4242",
"mandate": "<string>",
"multicapture": {
"status": "unavailable"
},
"network": "visa",
"network_token": {
"used": true
},
"overcapture": {
"maximum_amount_capturable": 120000,
"status": "unavailable"
},
"three_d_secure": "<string>",
"wallet": "<string>"
},
"type": "card"
},
"radar_options": {},
"receipt_email": "<string>",
"receipt_number": "<string>",
"receipt_url": "https://pay.stripe.com/receipts/payment/CAcaFwoVYWNjdF8xREl5WTRLNXpSVXpMd2FXKIeipa0GMgbREzVbrVQ6LBZdZFnB8ZFMPXXaJlPrlgymIpkqBm3-pd3x-lnhgqwlKAC3AWrN3kEYGDep",
"refunded": true,
"review": "<string>",
"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": "<string>",
"source_transfer": "<string>",
"statement_descriptor": "<string>",
"statement_descriptor_suffix": "<string>",
"status": "succeeded",
"transfer_data": "<string>",
"transfer_group": "<string>"
},
"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
Contains information related to the payment card used in the transaction.
The Card Verification Value (CVV) associated with the card.
The unique identifier associated with the card in Skyflow's secure vault.
The card number.
The name of the cardholder.
The expiration year of the card.
The expiration month of the card.
The first name of the client.
The last name of the client.
The email address of the client.
The phone number of the client.
The URL to which the user will be redirected after completing the transaction.
The identifier for the product.
The quantity of the product in the transaction.
The identifier for the shipping information.
The instance identifier for the shipping information.
The total monetary value of the transaction.
The title or type of shipping.
A description of the transaction.
The identifier for the device session.
A token identifier associated with the transaction.
An identifier or reference number for the order.
The identifier for the business.
The identifier for the payment.
The source of the transaction.
Response
The HTTP status code indicating the success or failure of the response.
A message providing additional information about the success or failure of the response.
The response from the payment service provider (PSP) containing detailed information about the payment transaction.
A unique identifier for the payment transaction within the payment service provider (PSP) system.
The type of object, representing the nature of the transaction (e.g., 'charge' for a payment charge).
The total amount of the transaction, expressed in the smallest currency unit (e.g., cents or pence).
The amount that has been captured or collected from the customer as part of the transaction.
The amount that has been refunded to the customer as part of the transaction.
The identifier of the application associated with the transaction, if applicable.
The application fee, if any, applied to the transaction.
The amount of the application fee, if any, applied to the transaction.
The identifier of the balance transaction associated with the payment charge.
Object containing details about the billing information.
Object containing details about the address in the billing details.
The city associated with the billing address.
The country associated with the billing address.
The first line of the billing address.
The second line of the billing address.
The postal code associated with the billing address.
The state or region associated with the billing address.
The email address associated with the billing details.
The name associated with the billing details.
The phone number associated with the billing details.
The calculated statement descriptor associated with the transaction.
Indicates whether the payment has been captured (true) or not (false).
The timestamp representing the creation date and time of the transaction.
The currency code associated with the transaction.
The identifier of the customer associated with the transaction.
A description or additional information about the transaction.
The destination of the transaction, if applicable.
The identifier of any dispute associated with the transaction, if applicable.
Indicates whether the transaction is disputed (true) or not (false).
The identifier of the balance transaction in case of failure, if applicable.
The code associated with the failure, if applicable.
A message providing details about the failure, if applicable.
Details about any fraud associated with the transaction, if applicable.
The identifier of the invoice associated with the transaction, if applicable.
Indicates whether the transaction was created in live mode (true) or test mode (false).
Additional metadata associated with the transaction.
The identifier of the account on behalf of which the transaction is performed, if applicable.
The identifier of the order associated with the transaction, if applicable.
Details about the outcome of the payment transaction.
The network status of the payment, indicating whether it was approved by the payment network.
The reason for the outcome, if available. For example, it might contain details if the payment was declined.
The risk level associated with the payment, indicating the perceived risk of the transaction.
The numerical risk score assigned to the payment transaction, providing a quantitative measure of risk.
A message for the seller providing information about the outcome of the payment, typically for display purposes.
The type of outcome, indicating the result of the payment authorization process (e.g., 'authorized', 'manual_review', 'issuer_declined').
A boolean indicating whether the payment has been successfully paid.
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.
The unique identifier of the payment method used for this transaction, such as a credit card or debit card.
Details about the payment method used for the transaction, including card details and type.
Details about the card used for the payment, including brand, checks, country, expiration, and more.
The amount authorized on the card, represented as an integer value.
The brand or type of the card used for the payment (e.g., Visa, MasterCard).
Various checks performed on the card details for validation purposes.
The result of the address line 1 check, indicating if it matches the card's billing address.
The result of the postal code check, indicating if it matches the card's billing postal code.
The result of the card security code (CVC) check.
The country where the card was issued.
The expiration month of the card.
The expiration year of the card.
Information about extended authorization status.
The status of extended authorization, indicating if it is enabled or disabled.
A unique identifier (fingerprint) for the card.
The funding source of the card, such as 'credit'.
Information about incremental authorization status.
The status of incremental authorization, indicating if it is available or unavailable.
The number of installments for the payment, if applicable.
The last four digits of the card number.
The mandate associated with the payment, if applicable.
Information about multicapture status.
The status of multicapture, indicating if it is available or unavailable.
The card network, such as Visa.
Information about the usage status of the network token.
A boolean indicating whether the network token has been used.
Information about overcapture status.
The maximum amount that can be captured for the payment.
The status of overcapture, indicating if it is available or unavailable.
The status of 3D Secure authentication, if applicable.
The type of wallet used for the payment, if applicable.
The type of payment method, such as 'card'.
Options related to Stripe Radar, which provides advanced fraud protection.
The email address to which the receipt for the transaction was sent, or null if no receipt was sent.
The receipt number associated with the transaction, or null if no receipt number is available.
The URL to view the receipt for the payment, or null if no receipt is available.
A boolean indicating whether the payment has been refunded.
The status of the payment review, or null if no review is in progress.
Information about the shipping address associated with the transaction.
The street address for shipping. If not applicable, set to 'N/a'.
The street number for shipping. If not applicable, set to 'N/a'.
The suburb or neighborhood for shipping. If not applicable, set to 'N/a'.
The city information for shipping.
The name of the city for shipping. If not applicable, set to 'N/a'.
The state information for shipping.
The name of the state for shipping. If not applicable, set to 'N/a'.
The country information for shipping.
The name of the country for shipping. If not applicable, set to 'N/a'.
The ZIP code for shipping. If not applicable, set to 'N/a'.
The ID of the payment source. If not applicable or available, set to null.
The ID of the transfer made from the payment source. If not applicable or available, set to null.
A custom statement descriptor for the payment. If not applicable or available, set to null.
A custom statement descriptor suffix for the payment. If not applicable or available, set to null.
The status of the payment transaction, e.g., 'succeeded'.
Information about the transfer associated with the payment. If not applicable or available, set to null.
The ID of the transfer group. If not applicable or available, set to null.
The status of the transaction, e.g., 'Success'.
The unique identifier for the transaction.
The unique identifier for the payment associated with the transaction.
The payment provider used for the transaction, e.g., 'stripe'.
Details about the next action required for the transaction. If not applicable, an empty object is provided.
An array of actions that can be performed for the transaction, each represented by an object with 'name', 'url', and 'method' properties.
The name of the action, e.g., 'verify_transaction_status'.
The URL endpoint for the action.
The HTTP method for the action, e.g., 'GET'.
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": "<string>",
"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": 123,
"application": "<string>",
"application_fee": "<string>",
"application_fee_amount": "<string>",
"balance_transaction": "txn_3OZyPSK5zRUzLwaW0iZIaxjx",
"billing_details": {
"address": {
"city": "<string>",
"country": "<string>",
"line1": "<string>",
"line2": "<string>",
"postal_code": "<string>",
"state": "<string>"
},
"email": "<string>",
"name": "<string>",
"phone": "<string>"
},
"calculated_statement_descriptor": "GOLFMANAGER.COM",
"captured": true,
"created": 1705595142,
"currency": "mxn",
"customer": "cus_PBoeaxFGw6mZFF",
"description": "transaction",
"destination": "<string>",
"dispute": "<string>",
"disputed": true,
"failure_balance_transaction": "<string>",
"failure_code": "<string>",
"failure_message": "<string>",
"fraud_details": {},
"invoice": "<string>",
"livemode": true,
"metadata": {},
"on_behalf_of": "<string>",
"order": "<string>",
"outcome": {
"network_status": "approved_by_network",
"reason": "<string>",
"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": "<string>",
"address_postal_code_check": "<string>",
"cvc_check": "<string>"
},
"country": "US",
"exp_month": 11,
"exp_year": 2025,
"extended_authorization": {
"status": "disabled"
},
"fingerprint": "g8tpcAz042MueZFZ",
"funding": "credit",
"incremental_authorization": {
"status": "unavailable"
},
"installments": "<string>",
"last4": "4242",
"mandate": "<string>",
"multicapture": {
"status": "unavailable"
},
"network": "visa",
"network_token": {
"used": true
},
"overcapture": {
"maximum_amount_capturable": 120000,
"status": "unavailable"
},
"three_d_secure": "<string>",
"wallet": "<string>"
},
"type": "card"
},
"radar_options": {},
"receipt_email": "<string>",
"receipt_number": "<string>",
"receipt_url": "https://pay.stripe.com/receipts/payment/CAcaFwoVYWNjdF8xREl5WTRLNXpSVXpMd2FXKIeipa0GMgbREzVbrVQ6LBZdZFnB8ZFMPXXaJlPrlgymIpkqBm3-pd3x-lnhgqwlKAC3AWrN3kEYGDep",
"refunded": true,
"review": "<string>",
"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": "<string>",
"source_transfer": "<string>",
"statement_descriptor": "<string>",
"statement_descriptor_suffix": "<string>",
"status": "succeeded",
"transfer_data": "<string>",
"transfer_group": "<string>"
},
"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"
}
]
}