Wompi

Rail overview

Use WOMPI when the Colombian checkout should support multiple local payment methods behind one hosted provider flow.

The provider owns the user interaction and sends the final state back to Conomy for payment lifecycle updates.

Region Colombia

Currency COP

Direction Pay-in

Model Hosted checkout gateway

Use it when conversion matters more than exposing a single bank-specific rail in your own UI.

Required fields

Field	Type	Description
`type`	`string`	Must be `"WOMPI"`
`currency`	`string`	Must be `"COP"`
`wompi.redirectUrl`	`string`	URL to redirect after payment
`wompi.customer.firstName`	`string`	Payer’s first name
`wompi.customer.email`	`string`	Payer’s email

Example

{
  "type": "WOMPI",
  "currency": "COP",
  "wompi": {
    "redirectUrl": "https://yourapp.com/return",
    "customer": {
      "firstName": "Luis",
      "email": "luis@example.com"
    }
  }
}

Response fields

Field	Description
`url`	Wompi-hosted checkout URL
`token`	Payment session token
`expiresAt`	Session expiration timestamp

Redirect the user to wompi.url to complete their 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.