Obtener link Web Checkout

POST /v3/payment/{uuid}/webcheckout

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í	API KEY del comercio
Signature	string	Sí	Firma del mensaje

Body

Campo	Tipo	Requerido	Descripción
return_url	string	Sí	URL de retorno al finalizar el pago, debe estar codificada en Base64
callback_url	string	Sí	URL Webhook, debe estar codificada Base64
payment_method	string	No	Medio de pago para el cual se requiere incializar el Web Checkout Valores: webpay, khipu, fintoc, mach, redpay, all.

Ejemplo de request

curl -X POST 'https://api.virtualpos-sandbox.com/v3/payment/{uuid}/webcheckout' \
  -H 'Content-Type: application/json' \
  -H "Authorization: $API_KEY" \
  -H "Signature: $SIGNATURE" \
  -d '{
  "return_url": "<return_url>",
  "callback_url": "<callback_url>",
  "payment_method": "webpay"
}'

Respuestas

200 OK

{
  "status": "OK",
  "code": 200,
  "commerce": {
    "commerce_id": "76123456-7",
    "name": "Comercial Andes"
  },
  "payment": {
    "client": {
      "email": "user@example.com",
      "first_name": "John",
      "last_name": "Doe",
      "social_id": "12345678-9",
      "phone": "56961934502"
    },
    "order": {
      "uuid": "57276136aad3ecad",
      "status": "pendiente",
      "created_at": "2023-01-30 23:48:48",
      "card_number": "",
      "authorized_at": "",
      "auth_code": "",
      "installment_amount": "",
      "installment_number": "",
      "payment_type_code": "",
      "amount": 9990,
      "merchant_internal_code": "OC_TEST_1234",
      "merchant_internal_channel": "portal_pagos",
      "deposits": []
    }
  },
  "url_redirect": "https://pay.virtualpos-sandbox.com/preview/083613a748190d26",
  "qr_encode": "aHR0cHM6Ly9wYXkudmlydHVhbHBvcy1zYW5kYm94LmNvbS9wcmV2aWV3LzA4MzYxM2E3NDgxOTBkMjY="
}

400 Bad Request

{
  "status": "NOK",
  "code": 400,
  "error": {
    "error_code": "E-###",
    "message": "detalle del error",
    "doc_url": "https://virtualpos.readme.io/reference/objeto-error"
  }
}