Placetopay Docs

POST/api/verification/validate

Validar Cuenta existente

Una vez realizada de manera exitosa la creación inicial de la sesión podrás realizar validaciones a la cuenta las veces que considere necesarias, solo debes tener la información de la cuenta y el código de verificación entregado en el proceso anterior.

Validaciones realizadas:

Actualmente el resultado de las validaciones se basa en las siguientes reglas:

Validación de cuenta existente: Se verifica que la cuenta exista y haya pasado por un proceso de creación de la sesión desde la interfaz gráfica del verificador de cuentas y además el token generado pertenezca al comercio con el cual se está autenticando.
Validación de cuenta activa: Se verifica que la cuenta exista y este activa en el proveedor de validación de cuentas, (PLAID, VaulPopular, Cuentas Comerciales, o el MOCK según corresponda).
Validación de monto disponible: Se verifica que la cuenta a validar tenga un monto mayor o igual al monto enviado en la solicitud.

Razones de estado

Código	Descripción
05	La verificación ha sido rechazada por razones generales.
BR	Los datos de la solicitud han sido incorrectos.
00	La verificación ha sido realizada con éxito.
XA	Monto no disponible para esta cuenta.
HX	Ha ocurrido un error en el servicio.
X3	La información suministrada es inválida.
X5	Número de seguridad social Inválido.
XN	Número de cuenta inválido.

Posibles estados

Nombre	Descripción
APPROVED	La cuenta fue verificada exitosamente.
REJECTED	La verificación de cuenta fue rechazada.
FAILED	Ha ocurrido un error en el sistema.

Solicitud

Name
auth
Type
object
is Required
REQUIRED
Description
La autenticación del sitio.
Name
login
Type
string
is Required
REQUIRED
Description
Name
tranKey
Type
string
is Required
REQUIRED
Description
Name
nonce
Type
string
is Required
REQUIRED
Description
Name
seed
Type
string
is Required
REQUIRED
Description
Name
account
Type
object
is optional
Description
Cuenta a la que se le realizará la validación. El código de verificación es requerido.
Name
bankName
Type
string
is optional
Description
Nombre del banco de la cuenta a procesar

<= 30 characters
Name
bankCode
Type
string
is optional
Description
Código que identifica al banco en la red

<= 17 characters
Name
accountType
Type
string
is optional
Description
Tipo de cuenta

Allowed values: SAV DDA CCD
Name
accountNumber
Type
string
is optional
Description
Número de cuenta

<= 17 characters
Name
franchise
Type
string
is optional
Description
<= 20 characters
Name
verificationCode
Type
string
is optional
Description
El verificationCode es un JSON Web Signature (JWS). Tiene el fin de ser el instrumento verificador del estado de la cuenta.

EJ:eyJhbGciOiJSUzI1NiJ9.eyJhY2NvdW50SGFzaCI6ImM5YWM2ZjFhZDhjNDA3Y2ZjNzMyNDljNTE2MTJjNTdmMWQxZGNiNTA4YjE4ZGJlYWE1MWQ0NDI5NjBjMjUwNDUyMzY4ZTg2YmUzMWQ3MDMxMDY4ZDM2MjM2NzVjYzhkYTUzNzhhODNmMTUwZjg5OTczOTBiZTEyMGU1ZmExN2RhIiwib25UZXN0Ijp0cnVlLCJzZXJ2aWNlIjoibW9jayIsImlkIjo0MDB9.dFMY4EwCrWq9EBmERFkKCoLHExPH4vgaCgnZaqB_mf8n3Sv6Qnu6Pb79onluX1OZecmYmBuHqZ_ykKXWSD4RMZSpckYFCiO3mlcJKI4qb91COhl_c2qXxYJuLEdbLfGlzf0k8-oJgFcO9gAS1Xm0hpTP4iiXF6st1hFwlfR3fpX4rr-bTsKgMvRSReMuxa0Vs92DykfqUR_3udlc0DFCPB9ZTaSqeRNHFAPAWNniUPWURQlW5c9J9xcyKTgKGzfI1_7h2I4ALQeRifptE2nC-HZtEMwtcToNh7hn0oL9lNFXnXGK9sWKORcyWKVfpEChS8z30UfX6kOhU6fp_qUwmA
Name
payment
Type
object
is optional
Description
Estructura que contiene la información acerca del pago de la transacción.
Name
amount
Type
object
is optional
Description
Estructura que contiene la información acerca del pago de la transacción.
Name
currency
Type
string
is optional
Description
>= 3 characters <= 3 characters

EJ : USD
Name
total
Type
number
is optional
Description
Name
locale
Type
string
is optional
Description
Default: en

EJ: es_CO

Solicitud

POST

api/verification/validate

curl -X "POST" https://checkout-test.placetopay.com/api/verification/validate \
  -H "Content-Type: application/json" \
  -d '{
        "auth": {
          "login": "5991de4fa93bcd7b28cf5100c25099e1",
          "tranKey": "OoamCdSidq121234430nH5x94yxd4=",
          "nonce": "NG5vejc2b41xdm8=",
          "seed": "2024-04-19T12:06:56-05:00"
        },
        "account": {
          "bankCode": "221571473",
          "bankName": "FIRSTBANK PUERTO RICO",
          "accountType": "CCD",
          "accountNumber": "41111111111111111",
          "franchise": "_221571473_",
          "verificationCode": "eyJhbYuiOiJSUzI1NmS1.eyJhY2NvdW50SGFzaCI6IjhkMzJkN2VjYjEyZDZmYjRmN2VlZmMzN2U4MmY2ZjI3YzNiYmY5Nzc3NjJkODAxZjQxYWZhN2Q0NWQ2YzI4YzU5YTU2NTM3YmZhM2E0NTM0MzhiMmU5M2Q4ODVkZDRiNDA1MjM5MjUwY2QzZGFkMDhhMzM2ZTJjYjM0Mjg0Y2RiIiwib25UZXN0IjpmYWxzZSwic2VydmljZSI6InBybWxjIiwiaWQiOjM4OX0.bXBuhT_xhA5vKJv3yVFJXYSYFJ4d49gmWuK2AC33GUfviAs2gSxrwZ8EHtFH4w37Pjzmq3y96uQZrllroGSlF7PySRqwxfNnem92ZKOs4EsFkzOdfBh73Z-RmCpKY6n5BQDjvVIg8hkwb2umnotjig1Zz_yHCBcvqQj5qkjj1N8HyT3KQtTOzItfDb4qf7uEAzONbcSN8YRYuRKvBMxKgJMSdeIu8Ah3zMOAhLxa1X0XnRr0a1gYudqQLowpnwQ7SP31Y_I3IlrXdBZqIYI12cciY_N1c11MsDuM1mtWhA0aJeVVzgdyq_DS0WOAiZy6Lsd26vY1ZR5Q5OsHYVIF5g"
        },
        "payment": {
          "amount": {
            "currency": "USD",
            "total": 100
          }
        },
        "locale": "es_ES"
  }'

Respuesta

Respuesta estado de validación

Name
status
Type
object
is optional
Description
Estructura que contiene la información sobre una solicitud o pago, informa al estado actual de la misma.
Name
status
Type
string
is optional
Description
Estado de la solicitud

Allowed values: OK FAILED APPROVED APPROVED_PARTIAL PARTIAL_EXPIRED REJECTED PENDING PENDING_VALIDATION PENDING_PROCESS REFUNDED REVERSED ERROR UNKNOWN MANUAL DISPUTE
Name
reason
Type
integer
is optional
Description
Código de respuesta

>= 1 characters <= 4 characters
Name
message
Type
string
is optional
Description
Mensaje de respuesta
Name
date
Type
string
is optional
Description
Fecha y hora de la respuesta

EJ: 2021-09-21T09:34:48-05:00

Respuesta

{
    "status": "APPROVED",
    "reason": "00",
    "message": "La verificación ha sido exítosa",
    "date": "2024-04-19T20:51:52+00:00"
}