Crear un Charge

POST /v3/charge

Ambiente	URL base API	Portal de comercio
Sandbox	https://api.virtualpos-sandbox.com	comercios.virtualpos-sandbox.com
Producción	https://api.virtualpos.cl	comercios.virtualpos.cl

Headers

Nombre	Tipo	Requerido	Descripción
Authorization	string	Sí	Clave de la API proporcionada en back-office virtualPOS.
Signature	string	Sí	La firma de los parámetros efectuada con su secret_key

Body

Campo	Tipo	Requerido	Descripción
charge_date	string	Sí	Fecha en que se realizará el cargo.
amount	number (float)	Sí	Monto a cargar
description	string	Sí	Descripción asociada al cargo.
suscription_id	string	Sí	Identificador de la suscripción
internal_code	string	No	Identificador del servicio.

Ejemplo de request

curl -X POST 'https://api.virtualpos-sandbox.com/v3/charge' \
  -H 'Content-Type: application/json' \
  -H "Authorization: $API_KEY" \
  -H "Signature: $SIGNATURE" \
  -d '{
  "charge_date": "<charge_date>",
  "amount": 0,
  "description": "<description>",
  "suscription_id": "<suscription_id>",
  "internal_code": "<internal_code>"
}'

Respuestas

200 OK

{
  "status": "OK",
  "code": 200,
  "suscription_id": "3a4d77f2e4",
  "charge": {
    "id": "id_2566645567e51ef2b7.76832273",
    "charge_date": "2023-05-08",
    "amount": 9900,
    "status": "pendiente",
    "description": "Cargo 1 de 3",
    "created_at": "2021-09-08 11:20:31"
  }
}

400 Bad Request

{}