Nequi

Rail overview

Use NEQUI when collecting from Colombian users who prefer wallet-based payment over bank transfer.

Conomy creates the payment instruction and waits for the wallet provider confirmation before the payment can settle.

Region Colombia

Currency COP

Direction Pay-in

Model Mobile wallet

Keep customer phone and document data consistent with the wallet profile to reduce rejected payments.

Required fields

Field	Type	Description
type	string	Must be "NEQUI"
currency	string	Must be "COP"
nequi.customer.phoneNumber	string	Nequi phone number (digits only)
nequi.customer.email	string	Customer’s email

Example

{
  "type": "NEQUI",
  "currency": "COP",
  "nequi": {
    "customer": {
      "phoneNumber": "3001234567",
      "email": "usuario@example.com"
    }
  }
}

Object

customerobjectrequired

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

addressobjectshow 8 properties

The entity’s address information.

successUrlstring

Redirect URL on successful payment.

failedUrlstring

Redirect URL on failed payment.