Nequi is a widely used digital wallet in Colombia. The API integration supports **Pay-ins** (collecting funds via QR Code or Push Notification) and **Payouts** (disbursing funds directly to a Nequi account). All flows are confirmed asynchronously via webhook.
#### Payment Methods Available
There are two primary ways for a customer to complete a payment with Nequi, determined by the `payment_method` field:
1. **Nequi QR (`WALLET`):** The API returns a `redirect_url`. The merchant can redirect the customer to this URL or render it as a QR code for the customer to scan using the Nequi app.
2. **Nequi Push (`WALLET_PUSH`):** The merchant triggers a push notification to the customer's phone number. The customer accepts the payment directly within the Nequi app.
## Requirements
Before integrating Nequi, you need to:
* Generate an access token through the [Authentication endpoint](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/authentication).
* Configure a public HTTPS `callback_url` to receive asynchronous status updates when the customer completes or rejects the payment.
* Ensure that the merchant account is configured for Colombia (CO) and COP currency.
* **For Payouts:** Ensure your merchant account has sufficient balance to cover the disbursement amount.
## Use Cases Specifics
When integrating Nequi via Getnet, specific market requirements apply. Nequi is only available in **Colombia** and supports **COP** currency.
* [Currency codes](https://docs.globalgetnet.com/en/articles?article=currency-codes)
* [Document types](https://docs.globalgetnet.com/en/articles?article=document-types)
* [Local taxes and regulations](https://docs.globalgetnet.com/en/articles?article=taxes-and-regulations)
## Characteristics
The table below summarizes the behavior and requirements for Nequi payment flows.
| Capability | Details |
| :--------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Customer experience** | **QR Flow:** Customer scans a code generated from the redirect URL. 
### 1. Create the payment request
To initiate a Nequi payment, call the [Create - Authorize endpoint](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/payments/post/dpm/payments-gwproxy/v2/payments).
You must choose the flow by setting the `payment_method` and provide the customer's mobile phone number (critical for the Push flow).
The table outlines the minimum fields required for a Nequi payment.
| Attribute | Description | Required value |
| :---------------------- | :------------------------------------ | :------------------------------------------------------------------------ |
| `payment_method` | Defines the flow type | `WALLET` (for QR Code flow) or `WALLET_PUSH` (for Push Notification flow) |
| `brand` | Nequi brand identifier | `NEQUI` |
| `callback_url` | Where status updates are sent | Your HTTPS endpoint |
| `amount` | Transaction amount in cents | Integer (e.g. `10000` for \$100.00 COP) |
| `currency` | ISO currency code | `COP` |
| `order_id` | Merchant reference for reconciliation | Unique string (max 32 characters) |
| `customer.phone_number` | Customer's mobile number | String (e.g., `3001234567`) |
#### Nequi Push Notification
Use `WALLET_PUSH`. The customer receives a notification on their phone. No redirect URL is returned in the response.
The following sample request shows how to initialize a Nequi push notification payment.
```bash
curl --location --request POST '[https://api.pre.globalgetnet.com/dpm/payments-gwproxy/v2/payments](https://api.pre.globalgetnet.com/dpm/payments-gwproxy/v2/payments)' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 
The user can either scan the QR using the Nequi mobile app or take a screenshot of the QR code and upload it to the app.
#### Push Notification
The user receives a push notification in the Nequi mobile app.
### 3. Verify payment status
Once the customer approves the payment, a webhook notification is sent to your configured `callback_url` with the updated status (`APPROVED` or `REJECTED`).
You can also manually check the status using the [Get Transaction endpoint](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/payment-record-management/get/dpm/hub-payment-info/v1/payments/info/{payment_id}).
## Payouts
The Nequi Payout solution allows merchants to disburse funds directly to a customer's Nequi digital wallet in Colombia. This is ideal for gig economy earnings, refunds, or gaming withdrawals.
The Getnet API simplifies the underlying process into a single request. You do not need to manually register the user or token; simply provide the customer's phone number and details in the payout request.
### Characteristics
The table below summarizes the behavior and requirements for Nequi Payouts.
| Capability | Details |
| :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------- |
| **Transaction Type** | **Disbursement** (Merchant sends funds to Customer). |
| **Confirmation** | Asynchronous — A webhook notification informs the merchant when the funds have been successfully credited. |
| **Data Requirements** | **Phone Number:** Must be exactly **10 digits**. **Customer Details:** First and Last name are required for the provider registration. | ### Payout flow The diagram below illustrates the business flow for a Nequi Payout:
#### 1. Create the payout request
To initiate the transfer, call the **Create Payout** endpoint. You must specify the `payment_method` as `WALLET_PAYOUT` and provide the customer's Nequi phone number.