PAGOS360 - Integracion QR Completa 1.0.0

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

Authentication

http bearerAuth

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.

Qr Dinamico

/batch-result/{id}/{page}

POST

/pay-qr/{qr_id}

Importar hasta 10000

Importar hasta 10000 QR.

Auth

Request Body

object	object
total_count	integer
data	array[object]
id	string
city	string
multiple_payment	boolean
description	string
first_due_date	string
first_total	number
payer_name	string
postal_code	string

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_id string

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

object	object
total_count	integer
data	array[object]
id	string
city	string
multiple_payment	boolean
description	string
first_due_date	string
first_total	number
payer_name	string
postal_code	string

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

object	object
total_count	integer
data	array[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

object	object
total_count	integer
data	array[object]
id	string
city	string
multiple_payment	boolean
description	string
first_due_date	string
first_total	number
payer_name	string
postal_code	string

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

object	object
total_count	integer
data	array[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

id	string
page	integer

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_id string

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

Qr Estatico

POST

/create-qr

GET

/status-static/{qr_id}

PUT

/new-transaction

POST

/pay-qr-static/{qr_id}

Crear

Auth

Request Body

object	object
id	string
qr_type	string
qr_name	string
city	string
postal_code	string
multiple_payment	string
description	string
payer_name	string

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_id string

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

data string

Request Body

object	object
first_total	number
active_period	integer
external_reference	string

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_id string

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