ETPay

Rail overview

Use ETPAY for Chilean bank-authorized topups where the user confirms the transfer through a redirect or bank authorization flow.

The user authorizes with the bank, the provider confirms the transfer, and Conomy updates the payment lifecycle through webhooks.

Region Chile

Currency CLP

Direction Pay-in

Model Open banking redirect

Always provide success and failure URLs so the user returns to your product with a clear state.

Required fields

Field	Type	Description
`type`	`string`	Must be `"ETPAY"`
`currency`	`string`	Must be `"CLP"`
`etpay.successUrl`	`string`	URL to redirect after successful payment
`etpay.failedUrl`	`string`	URL to redirect if payment fails
`etpay.customer.firstName`	`string`	Payer’s first name
`etpay.customer.email`	`string`	Payer’s email

Example

{
  "type": "ETPAY",
  "currency": "CLP",
  "etpay": {
    "successUrl": "https://yourapp.com/success",
    "failedUrl": "https://yourapp.com/failed",
    "customer": {
      "firstName": "Valentina",
      "email": "valentina@example.com"
    }
  }
}

Response fields

Field	Description
`url`	Redirect URL — send the user here to complete the payment
`expiresAt`	When the session expires

Redirect your user to etpay.url immediately after creating the payment.

Object

Information on who pays the transaction

idstring

Unique identifier for the internal service.

firstNamestringrequired

Payer's name

emailstring

Payer's email

lastNamestring

Payer's last name

phoneNumberstring

Payer's phone number without prefix

phoneNumberPrefixstring

Phone number prefix (e.g., +57)

documentTypestring

Documeny type of the entity (e.g., RUT, CURP, CURL). Go to the Supported Identity document types page for the complete list of supported values.

documentNumberstring

The document number associated with the documentType

addressobject

The entity’s address information.

Redirect url in case of success

Redirect url in case of failure