Payments / RailsFintoc
Fintoc
Chilean open banking pay-in via bank widget. Used for pay-in in Chile.
Rail overview
Use FINTOC when the Chilean pay-in experience should happen through an embedded bank widget instead of a full redirect.
Conomy receives the provider result after bank authorization and moves the payment through received and settled states.
Treat FINTOC as an interactive rail: keep the user in session until authorization is complete, then rely on webhooks for the final state.
Required fields
Section titled “Required fields”| Field | Type | Description |
|---|---|---|
type | string | Must be "FINTOC" |
currency | string | Must be "CLP" |
fintoc.customer | object | Optional payer information |
Example
Section titled “Example”{ "type": "FINTOC", "currency": "CLP", "fintoc": { "customer": { "firstName": "Diego", "email": "diego@example.com" } }}Response fields
Section titled “Response fields”| Field | Description |
|---|---|
url | Hosted widget URL — redirect the user here |
token | Session token for tracking |
Send the user to fintoc.url to complete the bank connection and authorization.
Object
Section titled “Object”Information on who pays the transaction
idstringUnique identifier for the internal service.
firstNamestringrequiredPayer's name
emailstringPayer's email
lastNamestringPayer's last name
phoneNumberstringPayer's phone number without prefix
phoneNumberPrefixstringPhone number prefix (e.g., +57)
documentTypestringDocumeny type of the entity (e.g., RUT, CURP, CURL). Go to the Supported Identity document types page for the complete list of supported values.
documentNumberstringThe document number associated with the documentType
addressobjectThe entity’s address information.
administrativeAreaLevel1stringThe first-level administrative division.
administrativeAreaLevel2stringThe second-level administrative division.
administrativeAreaLevel3stringThe third-level administrative division.
streetstringThe name of the street.
streetNumberstringThe street number.
optionalAddressstringAdditional address details.
countrystringCountry of operations for the entity, specified using the ISO 3166-1 alpha-3 standard (e.g., CHL, USA, MEX). Go to the countries page for the complete list of supported values.
zipcodestringZipcode f the address
Redirect URL on successful payment.
Redirect URL on failed payment.