curl --request POST 'https://api-empresas.uat.topup.com.co/production/api/v2/payin' \
--header 'Token-Top: your_auth_token' \
--header 'Authorization: Basic your_auth_key' \
--header 'Content-Type: application/json' \
--data-raw '{
"reference": "3cNPNGbX7meiMppXzVz7g781ysektqq5X",
"amount": 50000,
"currency": "COP",
"country": "CO",
"payment_method": "ALL_METHODS",
"description": "Test PayIn",
"customer_data": {
"legal_doc": "1234567890",
"legal_doc_type": "CC",
"phone_code": "57",
"phone_number": "3121234567",
"email": "customer@example.com",
"full_name": "John Doe"
},
"expiration_time": 720,
"ipn_url": "https://your-domain.com/webhook",
"redirect_url": "https://your-domain.com/payment/success"
}'
{
"code": "01",
"status": "SUCCESS",
"message": "Operacion exitosa",
"data": {
"ticket": "8BNsCFva1NKPqy2",
"date": "2025-10-15 17:58:36",
"payment_url": "https://link.uat.topup.com.co/payments/main?s=8BNsCFva1NKPqy2",
"transaction": {
"reference": "3cNPNGbX7meiMppXzVz7g781ysektqq5X",
"amount": 50000,
"currency": "COP",
"payment_method": "ALL_METHODS",
"redirect_url": "https://your-domain.com/payment/success",
"ipn_url": "https://your-domain.com/webhook",
"description": "Test PayIn"
}
}
}
PayIn API
POST Initiate PayIn Transaction (v2)
Create a PayIn transaction. Returns payment_url, payment_information, or both depending on payment_method and request fields.
POST
/
api
/
v2
/
payin
curl --request POST 'https://api-empresas.uat.topup.com.co/production/api/v2/payin' \
--header 'Token-Top: your_auth_token' \
--header 'Authorization: Basic your_auth_key' \
--header 'Content-Type: application/json' \
--data-raw '{
"reference": "3cNPNGbX7meiMppXzVz7g781ysektqq5X",
"amount": 50000,
"currency": "COP",
"country": "CO",
"payment_method": "ALL_METHODS",
"description": "Test PayIn",
"customer_data": {
"legal_doc": "1234567890",
"legal_doc_type": "CC",
"phone_code": "57",
"phone_number": "3121234567",
"email": "customer@example.com",
"full_name": "John Doe"
},
"expiration_time": 720,
"ipn_url": "https://your-domain.com/webhook",
"redirect_url": "https://your-domain.com/payment/success"
}'
{
"code": "01",
"status": "SUCCESS",
"message": "Operacion exitosa",
"data": {
"ticket": "8BNsCFva1NKPqy2",
"date": "2025-10-15 17:58:36",
"payment_url": "https://link.uat.topup.com.co/payments/main?s=8BNsCFva1NKPqy2",
"transaction": {
"reference": "3cNPNGbX7meiMppXzVz7g781ysektqq5X",
"amount": 50000,
"currency": "COP",
"payment_method": "ALL_METHODS",
"redirect_url": "https://your-domain.com/payment/success",
"ipn_url": "https://your-domain.com/webhook",
"description": "Test PayIn"
}
}
}
This is the recommended PayIn endpoint. The legacy v1 endpoint (
POST /api/v1/payin) is deprecated.POST /api/v2/payin).
The response includes payment_url, payment_information, or both depending on the payment method and request fields. See PayIn API and Colombia PayIn for method-specific examples (e.g. PSE checkout vs direct).
curl --request POST 'https://api-empresas.uat.topup.com.co/production/api/v2/payin' \
--header 'Token-Top: your_auth_token' \
--header 'Authorization: Basic your_auth_key' \
--header 'Content-Type: application/json' \
--data-raw '{
"reference": "3cNPNGbX7meiMppXzVz7g781ysektqq5X",
"amount": 50000,
"currency": "COP",
"country": "CO",
"payment_method": "ALL_METHODS",
"description": "Test PayIn",
"customer_data": {
"legal_doc": "1234567890",
"legal_doc_type": "CC",
"phone_code": "57",
"phone_number": "3121234567",
"email": "customer@example.com",
"full_name": "John Doe"
},
"expiration_time": 720,
"ipn_url": "https://your-domain.com/webhook",
"redirect_url": "https://your-domain.com/payment/success"
}'
{
"code": "01",
"status": "SUCCESS",
"message": "Operacion exitosa",
"data": {
"ticket": "8BNsCFva1NKPqy2",
"date": "2025-10-15 17:58:36",
"payment_url": "https://link.uat.topup.com.co/payments/main?s=8BNsCFva1NKPqy2",
"transaction": {
"reference": "3cNPNGbX7meiMppXzVz7g781ysektqq5X",
"amount": 50000,
"currency": "COP",
"payment_method": "ALL_METHODS",
"redirect_url": "https://your-domain.com/payment/success",
"ipn_url": "https://your-domain.com/webhook",
"description": "Test PayIn"
}
}
}
Required Headers
Request Body Parameters
Two-letter country code (ISO 3166-1 alpha-2):
CO, PE, MX, GT, or HN. Must match the merchant country and currency.Payment method. See Country-Specific Information for available payment methods.
Show Customer data object
Show Customer data object
The type of legal document provided. See Country-Specific Information for available document types.
Response
Authorizations
Body
application/json