Create Checkout Session

curl --request POST \
  --url https://api.fintoc.com/v1/checkout_sessions \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 1000,
  "currency": "CLP",
  "flow": "payment",
  "customer_email": "customer@example.com",
  "expires_at": "<string>",
  "metadata": "{\"order\":\"123456\"}",
  "success_url": "htttps://merchant.com/success",
  "cancel_url": "htttps://merchant.com/cancel",
  "customer": {
    "tax_id": {
      "value": "<string>",
      "type": ""
    },
    "name": "<string>",
    "email": "<string>",
    "metadata": "<string>"
  },
  "payment_method_types": [
    "<string>"
  ],
  "payment_method_options": {
    "payment_intent": {
      "recipient_account": {
        "holder_id": "183917137",
        "number": "123456",
        "type": "checking_account",
        "institution_id": "cl_banco_de_chile"
      },
      "sender_account": {
        "holder_id": {
          "value": "12345678-9",
          "editable": true
        },
        "institution_id": {
          "value": "cl_banco_estado"
        }
      }
    }
  },
  "business_profile": {
    "name": "<string>",
    "tax_id": "<string>",
    "category": "<string>"
  }
}
'

import requests

url = "https://api.fintoc.com/v1/checkout_sessions"

payload = {
    "amount": 1000,
    "currency": "CLP",
    "flow": "payment",
    "customer_email": "customer@example.com",
    "expires_at": "<string>",
    "metadata": "{\"order\":\"123456\"}",
    "success_url": "htttps://merchant.com/success",
    "cancel_url": "htttps://merchant.com/cancel",
    "customer": {
        "tax_id": {
            "value": "<string>",
            "type": ""
        },
        "name": "<string>",
        "email": "<string>",
        "metadata": "<string>"
    },
    "payment_method_types": ["<string>"],
    "payment_method_options": { "payment_intent": {
            "recipient_account": {
                "holder_id": "183917137",
                "number": "123456",
                "type": "checking_account",
                "institution_id": "cl_banco_de_chile"
            },
            "sender_account": {
                "holder_id": {
                    "value": "12345678-9",
                    "editable": True
                },
                "institution_id": { "value": "cl_banco_estado" }
            }
        } },
    "business_profile": {
        "name": "<string>",
        "tax_id": "<string>",
        "category": "<string>"
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: 1000,
    currency: 'CLP',
    flow: 'payment',
    customer_email: 'customer@example.com',
    expires_at: '<string>',
    metadata: '{"order":"123456"}',
    success_url: 'htttps://merchant.com/success',
    cancel_url: 'htttps://merchant.com/cancel',
    customer: {
      tax_id: {value: '<string>', type: ''},
      name: '<string>',
      email: '<string>',
      metadata: '<string>'
    },
    payment_method_types: ['<string>'],
    payment_method_options: {
      payment_intent: {
        recipient_account: {
          holder_id: '183917137',
          number: '123456',
          type: 'checking_account',
          institution_id: 'cl_banco_de_chile'
        },
        sender_account: {
          holder_id: {value: '12345678-9', editable: true},
          institution_id: {value: 'cl_banco_estado'}
        }
      }
    },
    business_profile: {name: '<string>', tax_id: '<string>', category: '<string>'}
  })
};

fetch('https://api.fintoc.com/v1/checkout_sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fintoc.com/v1/checkout_sessions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => 1000,
    'currency' => 'CLP',
    'flow' => 'payment',
    'customer_email' => 'customer@example.com',
    'expires_at' => '<string>',
    'metadata' => '{"order":"123456"}',
    'success_url' => 'htttps://merchant.com/success',
    'cancel_url' => 'htttps://merchant.com/cancel',
    'customer' => [
        'tax_id' => [
                'value' => '<string>',
                'type' => ''
        ],
        'name' => '<string>',
        'email' => '<string>',
        'metadata' => '<string>'
    ],
    'payment_method_types' => [
        '<string>'
    ],
    'payment_method_options' => [
        'payment_intent' => [
                'recipient_account' => [
                                'holder_id' => '183917137',
                                'number' => '123456',
                                'type' => 'checking_account',
                                'institution_id' => 'cl_banco_de_chile'
                ],
                'sender_account' => [
                                'holder_id' => [
                                                                'value' => '12345678-9',
                                                                'editable' => true
                                ],
                                'institution_id' => [
                                                                'value' => 'cl_banco_estado'
                                ]
                ]
        ]
    ],
    'business_profile' => [
        'name' => '<string>',
        'tax_id' => '<string>',
        'category' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fintoc.com/v1/checkout_sessions"

	payload := strings.NewReader("{\n  \"amount\": 1000,\n  \"currency\": \"CLP\",\n  \"flow\": \"payment\",\n  \"customer_email\": \"customer@example.com\",\n  \"expires_at\": \"<string>\",\n  \"metadata\": \"{\\\"order\\\":\\\"123456\\\"}\",\n  \"success_url\": \"htttps://merchant.com/success\",\n  \"cancel_url\": \"htttps://merchant.com/cancel\",\n  \"customer\": {\n    \"tax_id\": {\n      \"value\": \"<string>\",\n      \"type\": \"\"\n    },\n    \"name\": \"<string>\",\n    \"email\": \"<string>\",\n    \"metadata\": \"<string>\"\n  },\n  \"payment_method_types\": [\n    \"<string>\"\n  ],\n  \"payment_method_options\": {\n    \"payment_intent\": {\n      \"recipient_account\": {\n        \"holder_id\": \"183917137\",\n        \"number\": \"123456\",\n        \"type\": \"checking_account\",\n        \"institution_id\": \"cl_banco_de_chile\"\n      },\n      \"sender_account\": {\n        \"holder_id\": {\n          \"value\": \"12345678-9\",\n          \"editable\": true\n        },\n        \"institution_id\": {\n          \"value\": \"cl_banco_estado\"\n        }\n      }\n    }\n  },\n  \"business_profile\": {\n    \"name\": \"<string>\",\n    \"tax_id\": \"<string>\",\n    \"category\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fintoc.com/v1/checkout_sessions")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 1000,\n  \"currency\": \"CLP\",\n  \"flow\": \"payment\",\n  \"customer_email\": \"customer@example.com\",\n  \"expires_at\": \"<string>\",\n  \"metadata\": \"{\\\"order\\\":\\\"123456\\\"}\",\n  \"success_url\": \"htttps://merchant.com/success\",\n  \"cancel_url\": \"htttps://merchant.com/cancel\",\n  \"customer\": {\n    \"tax_id\": {\n      \"value\": \"<string>\",\n      \"type\": \"\"\n    },\n    \"name\": \"<string>\",\n    \"email\": \"<string>\",\n    \"metadata\": \"<string>\"\n  },\n  \"payment_method_types\": [\n    \"<string>\"\n  ],\n  \"payment_method_options\": {\n    \"payment_intent\": {\n      \"recipient_account\": {\n        \"holder_id\": \"183917137\",\n        \"number\": \"123456\",\n        \"type\": \"checking_account\",\n        \"institution_id\": \"cl_banco_de_chile\"\n      },\n      \"sender_account\": {\n        \"holder_id\": {\n          \"value\": \"12345678-9\",\n          \"editable\": true\n        },\n        \"institution_id\": {\n          \"value\": \"cl_banco_estado\"\n        }\n      }\n    }\n  },\n  \"business_profile\": {\n    \"name\": \"<string>\",\n    \"tax_id\": \"<string>\",\n    \"category\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fintoc.com/v1/checkout_sessions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": 1000,\n  \"currency\": \"CLP\",\n  \"flow\": \"payment\",\n  \"customer_email\": \"customer@example.com\",\n  \"expires_at\": \"<string>\",\n  \"metadata\": \"{\\\"order\\\":\\\"123456\\\"}\",\n  \"success_url\": \"htttps://merchant.com/success\",\n  \"cancel_url\": \"htttps://merchant.com/cancel\",\n  \"customer\": {\n    \"tax_id\": {\n      \"value\": \"<string>\",\n      \"type\": \"\"\n    },\n    \"name\": \"<string>\",\n    \"email\": \"<string>\",\n    \"metadata\": \"<string>\"\n  },\n  \"payment_method_types\": [\n    \"<string>\"\n  ],\n  \"payment_method_options\": {\n    \"payment_intent\": {\n      \"recipient_account\": {\n        \"holder_id\": \"183917137\",\n        \"number\": \"123456\",\n        \"type\": \"checking_account\",\n        \"institution_id\": \"cl_banco_de_chile\"\n      },\n      \"sender_account\": {\n        \"holder_id\": {\n          \"value\": \"12345678-9\",\n          \"editable\": true\n        },\n        \"institution_id\": {\n          \"value\": \"cl_banco_estado\"\n        }\n      }\n    }\n  },\n  \"business_profile\": {\n    \"name\": \"<string>\",\n    \"tax_id\": \"<string>\",\n    \"category\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

"{}"

"{}"

POST

checkout_sessions

Create Checkout Session

curl --request POST \
  --url https://api.fintoc.com/v1/checkout_sessions \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 1000,
  "currency": "CLP",
  "flow": "payment",
  "customer_email": "customer@example.com",
  "expires_at": "<string>",
  "metadata": "{\"order\":\"123456\"}",
  "success_url": "htttps://merchant.com/success",
  "cancel_url": "htttps://merchant.com/cancel",
  "customer": {
    "tax_id": {
      "value": "<string>",
      "type": ""
    },
    "name": "<string>",
    "email": "<string>",
    "metadata": "<string>"
  },
  "payment_method_types": [
    "<string>"
  ],
  "payment_method_options": {
    "payment_intent": {
      "recipient_account": {
        "holder_id": "183917137",
        "number": "123456",
        "type": "checking_account",
        "institution_id": "cl_banco_de_chile"
      },
      "sender_account": {
        "holder_id": {
          "value": "12345678-9",
          "editable": true
        },
        "institution_id": {
          "value": "cl_banco_estado"
        }
      }
    }
  },
  "business_profile": {
    "name": "<string>",
    "tax_id": "<string>",
    "category": "<string>"
  }
}
'

import requests

url = "https://api.fintoc.com/v1/checkout_sessions"

payload = {
    "amount": 1000,
    "currency": "CLP",
    "flow": "payment",
    "customer_email": "customer@example.com",
    "expires_at": "<string>",
    "metadata": "{\"order\":\"123456\"}",
    "success_url": "htttps://merchant.com/success",
    "cancel_url": "htttps://merchant.com/cancel",
    "customer": {
        "tax_id": {
            "value": "<string>",
            "type": ""
        },
        "name": "<string>",
        "email": "<string>",
        "metadata": "<string>"
    },
    "payment_method_types": ["<string>"],
    "payment_method_options": { "payment_intent": {
            "recipient_account": {
                "holder_id": "183917137",
                "number": "123456",
                "type": "checking_account",
                "institution_id": "cl_banco_de_chile"
            },
            "sender_account": {
                "holder_id": {
                    "value": "12345678-9",
                    "editable": True
                },
                "institution_id": { "value": "cl_banco_estado" }
            }
        } },
    "business_profile": {
        "name": "<string>",
        "tax_id": "<string>",
        "category": "<string>"
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: 1000,
    currency: 'CLP',
    flow: 'payment',
    customer_email: 'customer@example.com',
    expires_at: '<string>',
    metadata: '{"order":"123456"}',
    success_url: 'htttps://merchant.com/success',
    cancel_url: 'htttps://merchant.com/cancel',
    customer: {
      tax_id: {value: '<string>', type: ''},
      name: '<string>',
      email: '<string>',
      metadata: '<string>'
    },
    payment_method_types: ['<string>'],
    payment_method_options: {
      payment_intent: {
        recipient_account: {
          holder_id: '183917137',
          number: '123456',
          type: 'checking_account',
          institution_id: 'cl_banco_de_chile'
        },
        sender_account: {
          holder_id: {value: '12345678-9', editable: true},
          institution_id: {value: 'cl_banco_estado'}
        }
      }
    },
    business_profile: {name: '<string>', tax_id: '<string>', category: '<string>'}
  })
};

fetch('https://api.fintoc.com/v1/checkout_sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fintoc.com/v1/checkout_sessions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => 1000,
    'currency' => 'CLP',
    'flow' => 'payment',
    'customer_email' => 'customer@example.com',
    'expires_at' => '<string>',
    'metadata' => '{"order":"123456"}',
    'success_url' => 'htttps://merchant.com/success',
    'cancel_url' => 'htttps://merchant.com/cancel',
    'customer' => [
        'tax_id' => [
                'value' => '<string>',
                'type' => ''
        ],
        'name' => '<string>',
        'email' => '<string>',
        'metadata' => '<string>'
    ],
    'payment_method_types' => [
        '<string>'
    ],
    'payment_method_options' => [
        'payment_intent' => [
                'recipient_account' => [
                                'holder_id' => '183917137',
                                'number' => '123456',
                                'type' => 'checking_account',
                                'institution_id' => 'cl_banco_de_chile'
                ],
                'sender_account' => [
                                'holder_id' => [
                                                                'value' => '12345678-9',
                                                                'editable' => true
                                ],
                                'institution_id' => [
                                                                'value' => 'cl_banco_estado'
                                ]
                ]
        ]
    ],
    'business_profile' => [
        'name' => '<string>',
        'tax_id' => '<string>',
        'category' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fintoc.com/v1/checkout_sessions"

	payload := strings.NewReader("{\n  \"amount\": 1000,\n  \"currency\": \"CLP\",\n  \"flow\": \"payment\",\n  \"customer_email\": \"customer@example.com\",\n  \"expires_at\": \"<string>\",\n  \"metadata\": \"{\\\"order\\\":\\\"123456\\\"}\",\n  \"success_url\": \"htttps://merchant.com/success\",\n  \"cancel_url\": \"htttps://merchant.com/cancel\",\n  \"customer\": {\n    \"tax_id\": {\n      \"value\": \"<string>\",\n      \"type\": \"\"\n    },\n    \"name\": \"<string>\",\n    \"email\": \"<string>\",\n    \"metadata\": \"<string>\"\n  },\n  \"payment_method_types\": [\n    \"<string>\"\n  ],\n  \"payment_method_options\": {\n    \"payment_intent\": {\n      \"recipient_account\": {\n        \"holder_id\": \"183917137\",\n        \"number\": \"123456\",\n        \"type\": \"checking_account\",\n        \"institution_id\": \"cl_banco_de_chile\"\n      },\n      \"sender_account\": {\n        \"holder_id\": {\n          \"value\": \"12345678-9\",\n          \"editable\": true\n        },\n        \"institution_id\": {\n          \"value\": \"cl_banco_estado\"\n        }\n      }\n    }\n  },\n  \"business_profile\": {\n    \"name\": \"<string>\",\n    \"tax_id\": \"<string>\",\n    \"category\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fintoc.com/v1/checkout_sessions")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 1000,\n  \"currency\": \"CLP\",\n  \"flow\": \"payment\",\n  \"customer_email\": \"customer@example.com\",\n  \"expires_at\": \"<string>\",\n  \"metadata\": \"{\\\"order\\\":\\\"123456\\\"}\",\n  \"success_url\": \"htttps://merchant.com/success\",\n  \"cancel_url\": \"htttps://merchant.com/cancel\",\n  \"customer\": {\n    \"tax_id\": {\n      \"value\": \"<string>\",\n      \"type\": \"\"\n    },\n    \"name\": \"<string>\",\n    \"email\": \"<string>\",\n    \"metadata\": \"<string>\"\n  },\n  \"payment_method_types\": [\n    \"<string>\"\n  ],\n  \"payment_method_options\": {\n    \"payment_intent\": {\n      \"recipient_account\": {\n        \"holder_id\": \"183917137\",\n        \"number\": \"123456\",\n        \"type\": \"checking_account\",\n        \"institution_id\": \"cl_banco_de_chile\"\n      },\n      \"sender_account\": {\n        \"holder_id\": {\n          \"value\": \"12345678-9\",\n          \"editable\": true\n        },\n        \"institution_id\": {\n          \"value\": \"cl_banco_estado\"\n        }\n      }\n    }\n  },\n  \"business_profile\": {\n    \"name\": \"<string>\",\n    \"tax_id\": \"<string>\",\n    \"category\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fintoc.com/v1/checkout_sessions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": 1000,\n  \"currency\": \"CLP\",\n  \"flow\": \"payment\",\n  \"customer_email\": \"customer@example.com\",\n  \"expires_at\": \"<string>\",\n  \"metadata\": \"{\\\"order\\\":\\\"123456\\\"}\",\n  \"success_url\": \"htttps://merchant.com/success\",\n  \"cancel_url\": \"htttps://merchant.com/cancel\",\n  \"customer\": {\n    \"tax_id\": {\n      \"value\": \"<string>\",\n      \"type\": \"\"\n    },\n    \"name\": \"<string>\",\n    \"email\": \"<string>\",\n    \"metadata\": \"<string>\"\n  },\n  \"payment_method_types\": [\n    \"<string>\"\n  ],\n  \"payment_method_options\": {\n    \"payment_intent\": {\n      \"recipient_account\": {\n        \"holder_id\": \"183917137\",\n        \"number\": \"123456\",\n        \"type\": \"checking_account\",\n        \"institution_id\": \"cl_banco_de_chile\"\n      },\n      \"sender_account\": {\n        \"holder_id\": {\n          \"value\": \"12345678-9\",\n          \"editable\": true\n        },\n        \"institution_id\": {\n          \"value\": \"cl_banco_estado\"\n        }\n      }\n    }\n  },\n  \"business_profile\": {\n    \"name\": \"<string>\",\n    \"tax_id\": \"<string>\",\n    \"category\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

"{}"

"{}"

v1 · Base URL https://api.fintoc.com/v1

Headers

Authorization

string

Fintoc API Secret Key

Body

application/json

amount

integer<int32>

default:1000

required

Amount to pay, represented as an integer [blocked]. This value must always be greater than 0 and less than 7,000,000, which is the maximum amount allowed by any bank.

currency

string

default:CLP

required

Currency ISO code. For now, we only support CLP and MXN.

flow

enum<string>

default:payment

Available options:

payment

customer_email

string

default:customer@example.com

A customer email linked to a Checkout Session. This is used to notify a user in case of a refund.

expires_at

string

ISO 8601 format (YYYY-MM-DD) timestamp that indicates when the session will expire

metadata

string<json>

default:{"order":"123456"}

Set of key-value [blocked] pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

success_url

string

default:htttps://merchant.com/success

URL to redirect the user in case of payment succeeded. Required if you want to use the redirection payment flow.

cancel_url

string

default:htttps://merchant.com/cancel

URL to redirect the user in case they decide to cancel the payment and return to your website. Required if you want to use the redirection payment flow.

customer

object

Information about the customer of the session

Show child attributes

payment_method_types

string[]

Optional definition of the available payment method(s) for the session. Methods current available are bank_transfer and card

payment_method_options

object

Optional list of settings to configure the payment method used to complete the payment

Show child attributes

business_profile

object

Enrolled merchant identifier used for category-based billing. It can be set as required in your organization's billing configuration.

Show child attributes

Response

200

The response is of type object.

Checkout Session object Retrieve Checkout Session

Fintoc API

Main Resources

Payment Initiation API

Transfers API

Movements API

Direct Debit and Subscriptions

Fiscal API

Billing API

Create Checkout Session

Headers

Body

Response