Payments / RailsDavivienda
Davivienda
Davivienda's direct pay-in button. Used for pay-in in Colombia.
Rail overview
Use DAVIVIENDA for Colombian pay-ins where the user authorizes through Davivienda directly.
The user completes the bank interaction, the provider confirms the transfer, and Conomy updates the payment status asynchronously.
Use redirect state for UX only; use webhooks as the source of truth for fulfillment.
Required fields
Section titled “Required fields”| Field | Type | Description |
|---|---|---|
type | string | Must be "DAVIVIENDA" |
currency | string | Must be "COP" |
davivienda.customer.email | string | Payer’s email |
davivienda.bankId | string | Bank identifier |
Example
Section titled “Example”{ "type": "DAVIVIENDA", "currency": "COP", "davivienda": { "bankId": "10006000", "customer": { "email": "usuario@example.com" } }}Response fields
Section titled “Response fields”| Field | Description |
|---|---|
url | Redirect URL to Davivienda’s authorization 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.