Payments / RailsWebpay
Webpay
Chile Transbank card and transfer gateway. Used for pay-in in Chile.
Rail overview
Use WEBPAY when a Chilean user should complete a card or Transbank-supported checkout flow.
The provider handles the hosted payment interaction and Conomy receives the confirmation before settling funds into the configured destination account.
Use it for user-present checkout flows where redirect completion and webhook confirmation both matter.
Required fields
Section titled “Required fields”type(string): Must be"WEBPAY".currency(string): Must be"CLP".webpay.customer.firstName(string): Payer first name.webpay.customer.lastName(string): Payer last name.webpay.customer.email(string): Payer email.
Example
Section titled “Example”{ "type": "WEBPAY", "currency": "CLP", "webpay": { "customer": { "firstName": "Sebastian", "lastName": "Rojas", "email": "sebastian@example.com" } }}Response fields
Section titled “Response fields”url: Transbank-hosted payment URL.token: Session token.
Redirect your user to webpay.url to complete the payment on the Transbank page.
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.