Autorizar un objeto Payment

POST /v3/payment/{uuid}/authorize

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

Body

Campo	Tipo	Requerido	Descripción
payment_method_type	string	Sí	Tipo de medio de pago a utilizar para autorizar el objeto payment Valores: CREDIT_CARD, TOKEN_CARD.
credit_card	object	No	Objeto que representa la tarjeta de crédito a utilizar para autorizar el Payment.
credit_card.card_number	string	Sí	Número de la tarjeta de crédito
credit_card.expiration_date	string	Sí	Fecha de expiración de la tarjeta de crédito, formato :AA/MM
credit_card.cvv	string	Sí	Código de seguridad de la tarjeta de crédito
token_card	string	No	Token a utilizar para autorizar el Payment.
installments_number	integer (int32)	No	Cantidad de cuotas en que se realizará el pago

Ejemplo de request

curl -X POST 'https://api.virtualpos-sandbox.com/v3/payment/{uuid}/authorize' \
  -H 'Content-Type: application/json' \
  -H "Authorization: $API_KEY" \
  -H "Signature: $SIGNATURE" \
  -d '{
  "payment_method_type": "CREDIT_CARD",
  "credit_card": {
    "card_number": "<card_number>",
    "expiration_date": "<expiration_date>",
    "cvv": "<cvv>"
  },
  "token_card": "<token_card>",
  "installments_number": 0
}'

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": "083613a748190d26",
      "status": "pagado",
      "created_at": "2021-09-08 11:20:31",
      "card_number": 1234,
      "authorized_at": "2021-09-08 11:21:31",
      "auth_code": "1234",
      "installment_amount": 0,
      "installment_number": 0,
      "payment_type_code": "VN",
      "amount": 9990,
      "merchant_internal_code": "OC-1234",
      "merchant_internal_channel": "portal_pagos",
      "response_code": 0,
      "deposits": [
        {
          "description": "1/1",
          "installment": 9900,
          "processing_flat_fee": 0,
          "processing_fee": 117,
          "payout_amount": 9783,
          "payout_date": "2021-09-21"
        }
      ]
    }
  }
}

201 Created · rejected

{
  "status": "OK",
  "code": 201,
  "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": "083613a748190d26",
      "status": "rechazado",
      "created_at": "2021-09-08 11:20:31",
      "card_number": 1234,
      "authorized_at": "",
      "auth_code": "",
      "installment_amount": 0,
      "installment_number": 0,
      "payment_type_code": "VN",
      "amount": 9990,
      "merchant_internal_code": "OC-1234",
      "merchant_internal_channel": "portal_pagos",
      "deposits": []
    }
  }
}

400 Bad Request

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