QR

Mostrá el QR del comercio con o sin monto.

Generar qr estático sin monto

GET /api/paymentQr

Headers

Key	Value
Content-Type	application/json
apikey	su_api_key
X-TRACE-ID	uuidv4()
X-VERSION	1

Request Body

{}

Generar qr dinámico con monto

POST /api/paymentQr

Request Body

Name	Type	Description
totalAmount	number	monto del qr

Response

200 OK

// response.successUrl será su link de pago

{
    "success": "ok",
    "data": {
        "id": "number",
        "imgUrl": "string",
        "qrString": "string",
        "subscriptionUrl": "string",
        "hash": "string"
    },
    "whatsappUrl": "string",
    "facebookUrl": "string"
}

400 Bad Request

// Si no se envía 'amount'

{
    "statusText": "Bad Request",
    "jsonSchemaValidation": true,
    "validations": {
        "body": [
            {
                "keyword": "string",
                "dataPath": "string",
                "schemaPath": "string",
                "params": {
                    "missingProperty": "string"
                },
                "message": "string"
            }
        ]
    }
}

401 Unauthorized

// Si apikey no es enviado en el Headers: 
{"message":"Missing API key found in request"}

// Si apikey es enviada de forma errónea:
{"message":"Invalid API key in request"}

500 Internal Server Error

// Error de parámetros

{
   "status": 500,
   "message": "status 500",
   "timestamp": "2024-05-28T12:30:04Z"
}

Aquí algunos ejemplos de peticiones:

cURL

curl --location 'http://api-gwt.sipago.online/services/api/paymentButtonsToken' \
--header 'apikey: su_api_key' \
--header 'X-TRACE-ID: uuidv4()' \
--header 'X-VERSION: 1' \
--header 'Content-Type: application/json' \
--data '{"amount": 100, "description": "coca-cola"}'

NodeJs - Axios

const axios = require('axios');
let data = JSON.stringify({
  "amount": 100,
  "description": "coca-cola"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'http://api-gwt.sipago.online/services/api/paymentButtonsToken',
  headers: { 
    'apikey': 'su_api_key', 
    'X-TRACE-ID': 'uuid', 
    'X-VERSION': '100', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Python - Requests

import requests
import json

url = "http://api-gwt.sipago.online/services/api/paymentButtonsToken"

payload = json.dumps({
  "amount": 100,
  "description": "coca-cola"
})
headers = {
  'apikey': 'su_api_key',
  'X-TRACE-ID': 'uuid',
  'X-VERSION': '100',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)