La API para desarrolladores de PAGOS360 permite administrar aspectos de tu cuenta PAGOS360. Aquí podrás explorar los diferentes endpoints, consultar las descripciones y ver ejemplos de peticiones (requests) y respuestas (responses) para operar con QR interoperables.

Server
https://qr.sandbox.pagos360.com

Sandbox (Test)

https://qr.pagos360.com

Producción

Server Variables

Todas las peticiones privadas requieren una API Key, que es un token de acceso del tipo Bearer que se envía en cada petición HTTP por medio de la cabecera (header) Authorization.Las API Key pueden ser generadas accediendo a tu cuenta PAGOS360 desde la sección de Integraciones.

Importar hasta 10000

Importar hasta 10000 QR.

Auth
Request Body
objectobject
total_countinteger
data8 fieldsarray[object]
POST /save-qr-data
curl --request POST \
--url 'https://qr.sandbox.pagos360.com/save-qr-data' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data '{
"total_count": "{integer}",
"data": [
{
"id": "{string}",
"city": "{string}",
"multiple_payment": "{boolean}",
"description": "{string}",
"first_due_date": "{string}",
"first_total": "{number}",
"payer_name": "{string}",
"postal_code": "{string}"
}
]
}'
Copy
Responses
201

QR creados exitosamente.

No response body
Response
{
"accepted_count": 2,
"status": "success"
}
Copy

Consultar QR

Auth
Path Params
qr_idstring
GET /status/{qr_id}
curl --get \
--url 'https://qr.sandbox.pagos360.com/status/{qr_id}' \
--header 'Authorization: Bearer {token}'
Copy
Responses
200

Detalle del QR.

No response body
Response
{
"id": "ID-123",
"status": "pending",
"qr_string": "0002010102124300..."
}
Copy

Editar QR

Edicion de un unico registro QR.

Auth
Request Body
objectobject
total_countinteger
data8 fieldsarray[object]
POST /edit-qr/{qr_id}
curl --request POST \
--url 'https://qr.sandbox.pagos360.com/edit-qr/{qr_id}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data '{
"total_count": 1,
"data": [
{
"id": "{string}",
"city": "{string}",
"multiple_payment": "{boolean}",
"description": "{string}",
"first_due_date": "{string}",
"first_total": "{number}",
"payer_name": "{string}",
"postal_code": "{string}"
}
]
}'
Copy
Responses
200

QR editado correctamente.

No response body
Response
{
"status": "updated",
"updated_count": 1
}
Copy

Eliminar QR

Eliminacion de un unico registro QR.

Auth
Request Body
objectobject
total_countinteger
dataarray[string]
DELETE /delete-qr/{qr_id}
curl --request DELETE \
--url 'https://qr.sandbox.pagos360.com/delete-qr/{qr_id}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data '{
"total_count": 1,
"data": "ID-1"
}'
Copy
Responses
200

QR eliminado.

No response body
Response
{
"status": "deleted"
}
Copy

Editar hasta 10000

Procesamiento por lotes para edicion masiva.

Auth
Request Body
objectobject
total_countinteger
data8 fieldsarray[object]
POST /batch-edit-qr
curl --request POST \
--url 'https://qr.sandbox.pagos360.com/batch-edit-qr' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data '{
"total_count": "{integer}",
"data": [
{
"id": "{string}",
"city": "{string}",
"multiple_payment": "{boolean}",
"description": "{string}",
"first_due_date": "{string}",
"first_total": "{number}",
"payer_name": "{string}",
"postal_code": "{string}"
}
]
}'
Copy
Responses
200

Lote de QR editado.

No response body
Response
{
"status": "updated",
"updated_count": 500
}
Copy

Eliminar hasta 10000

Procesamiento por lotes para eliminacion masiva.

Auth
Request Body
objectobject
total_countinteger
dataarray[string]
DELETE /batch-delete-qr
curl --request DELETE \
--url 'https://qr.sandbox.pagos360.com/batch-delete-qr' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data '{
"total_count": "{integer}",
"data": [
"{array[string]...}"
]
}'
Copy
Responses
200

Lote de QR eliminado.

No response body
Response
{
"status": "deleted",
"deleted_count": 500
}
Copy

Importar hasta 100000 (Obtener URL)

Auth
GET /bucket-url
curl --get \
--url 'https://qr.sandbox.pagos360.com/bucket-url' \
--header 'Authorization: Bearer {token}'
Copy
Responses
200

URL del bucket obtenida.

No response body
Response
{
"bucket_url": "https://storage.googleapis.com/pagos360/upload"
}
Copy

Importar hasta 100000 (Consultar Resultado)

Auth
Path Params
idstring
pageinteger
GET /batch-result/{id}/{page}
curl --get \
--url 'https://qr.sandbox.pagos360.com/batch-result/{id}/{page}' \
--header 'Authorization: Bearer {token}'
Copy
Responses
200

Resultado del procesamiento batch.

No response body
Response
{
"status": "completed"
}
Copy

Pagar QR

Auth
Path Params
qr_idstring
POST /pay-qr/{qr_id}
curl --request POST \
--url 'https://qr.sandbox.pagos360.com/pay-qr/{qr_id}' \
--header 'Authorization: Bearer {token}'
Copy
Responses
200

Pago simulado exitosamente.

No response body
Response
{
"status": "paid"
}
Copy

Crear

Auth
Request Body
objectobject
idstring
qr_typestring
qr_namestring
citystring
postal_codestring
multiple_paymentstring
descriptionstring
payer_namestring
POST /create-qr
curl --request POST \
--url 'https://qr.sandbox.pagos360.com/create-qr' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data '{
"id": "{string}",
"qr_type": "static_open_amount",
"qr_name": "{string}",
"city": "{string}",
"postal_code": "{string}",
"multiple_payment": "{string}",
"description": "{string}",
"payer_name": "{string}"
}'
Copy
Responses
201

QR Estatico creado.

No response body
Response
{
"qr_id": "ID-ESTATICO-1"
}
Copy

Consultar

Auth
Path Params
qr_idstring
GET /status-static/{qr_id}
curl --get \
--url 'https://qr.sandbox.pagos360.com/status-static/{qr_id}' \
--header 'Authorization: Bearer {token}'
Copy
Responses
200

Estado del QR estatico.

No response body
Response
{
"id": "ID-ESTATICO-1",
"status": "active"
}
Copy

Generar Nueva Transaccion

Auth
Query String
datastring
Request Body
objectobject
first_totalnumber
active_periodinteger
external_referencestring
PUT /new-transaction
curl --request PUT \
--url 'https://qr.sandbox.pagos360.com/new-transaction' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data data={data} \
--data '{
"first_total": "{number}",
"active_period": "{integer}",
"external_reference": "{string}"
}'
Copy
Responses
200

Transaccion generada para el monto cerrado.

No response body
Response
{
"status": "success"
}
Copy

Pagar

Auth
Path Params
qr_idstring
POST /pay-qr-static/{qr_id}
curl --request POST \
--url 'https://qr.sandbox.pagos360.com/pay-qr-static/{qr_id}' \
--header 'Authorization: Bearer {token}'
Copy
Responses
200

Pago de QR estatico procesado.

No response body
Response
{
"status": "paid"
}
Copy