API Pago Link Integrado

Flujo de uso de las API #

Aquí podrás visualizar el flujo de uso de cada de las API que se encuentran en esta sección.

Fujo API Pago Link Integrado Fujo API Pago Link Integrado

API de Seguridad #


A. Descripción

Esta API permitirá generar un token de acceso, el cual será utilizado en la llamada de otras APIs funcionales. El token de acceso generado por esta API tiene un tiempo de duración. Pasado ese tiempo, el token de acceso no podrá ser utilizado y se tendrá que generar un nuevo token de acceso utilizando la misma API.

El comercio afiliado debe asegurar que su integración (desarrollo) sea lo más segura posible aplicando las medidas preventivas que considere necesario.

Todas las invocaciones a las APIs (servicios backend) de Niubiz tienen que ser realizadas host to host.



B. Endpoint

Ambiente URL de API
Testing https://apisandbox.vnforappstest.com/api.security/v1/security
Producción https://apiprod.vnforapps.com/api.security/v1/security
Ambiente URL de API
Testing https://apisandbox.vnforappstest.com/api.security/v1/security
Producción https://apiprod.vnforapps.com/api.security/v1/security


C. Request y Casos:

  C.1 Tabla de campos

Campo Tipo Longitud Obligatorio Descripción
HEADER
userName Texto Max 100 SI Usuario compartido con el comercio para la integración
password Texto Max 100 SI Contraseña compartida con el comercio para la integración


  C.2 Trama de ejemplo:

Request

GET /api.security/v1/security HTTP/1.1

Host: apisandbox.vnforappstest.com

Authorization: Basic Z2lhbmNhZ2FsbGFyZG9AZ21haWwuY29tOkF2MyR0cnV6

(*) Authorization: Basic EncodeBase64(“userName” + “:” + “password”)



D. Response

  D.1 Tabla de campos

Campo Tipo Longitud Obligatorio Descripción
TRAMA EXITOSA: 201
accessToken Texto Max 1000 SI Token de acceso generado con la API
TRAMA ERROR: 401, 500
description Texto Max 1000 SI Descripción relacionada al error


D.2 Trama de ejemplo

  • Caso 201
  • Caso 401
  • Caso 500

Status Code 200 OK

Content-Type: text/plain

eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM 3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJkMTlhM2I0Zi01NzYxLTRlYTEtY jBmYS1iNWNiNjU5OWQ5NWQiLCJjb2duaXRvOmdyb3VwcyI6WyJjdXN0b2RpbyJdLCJldmV udF9pZCI6ImM2OTZmZjVkLTZjOTctNDE4NC05MGIxLTA5NjM2MWY4M2E2ZSIsInRva2Vu X3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiYXdzLmNvZ25pdG8uc2lnbmluLnVzZXIuYWRta W4iLCJhdXRoX3RpbWUiOjE2MDIxMTM4NzksImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLW lkcC51cy1lYXN0LTEuYW1hem9uYXdzLmNvbVwvdXMtZWFzdC0xXzJjSjFTZTFmSSIsIm V4cCI6MTYwMjExNzQ3OSwiaWF0IjoxNjAyMTEzODc5LCJqdGkiOiJiOTVmOGU0ZS1kZGE4LTR kZmUtOTc0NC1kOGQwZGEyMDFlMzMiLCJjbGllbnRfaWQiOiIxMGx2MDYxN281ZGljN TFlYnNucWVpaWpiNyIsInVzZXJuYW1lIjoiZ2lhbmNhZ2FsbGFyZG9AZ21haWwuY29tIn0. GrO2XLoMnChN3Dg6H8G7LC3ZY4O_c1-DwvRYHCx8iiDqprFMK7jU43vo6W4ILNqP_QA1s DoEQaD9HJJ7iLfVBojh1tgiFyzFzkX4T3m63eHRSFfIZAToTGYOQoeZchsYb3UAffvrzR1JlUP jwf3U1YRfBEu8ueIR6_OUMZdXC8TLS3pqEpXnPr6S-_bndpFRs5wZpt0BPSJ4OnhM2AYh 6pqFucjL9nsPmIaujJQVwdR8oNcrfeFuIv5t55H_DRDpQCSYstac1nFSm00P3EMdbOX6Lh8dTU 5dBOXe17Bfh7mDEP-FnF_J47COVFB_sYh7JXyePfK6kKTlSeV0Ev0pew



E. Códigos de Respuesta

Código Descripción
201 Token de acceso creado de forma satisfactoria
401 Error, las credenciales utilizadas no son válidas
500 Cualquier otro tipo de error

API de Creación de Orden Única #


A. Descripción y consideraciones

Esta API permitirá realizar la creación de un link de pago que podrás enviar a tu cliente y este al recibirlo podrá finalizar la transacción de venta; considerar que el envío de la URL no forma parte de esta solución. Para que esta API pueda resolver una operación necesita de un token de acceso vigente generado por el API de Seguridad.

El comercio afiliado debe asegurar que su integración (desarrollo) sea lo más segura posible aplicando las medidas preventivas que considere necesario.

Todas las invocaciones a las APIs (servicios backend) de Niubiz tienen que ser realizadas host to host.



B. Endpoint

Ambiente URL API
Testing https://apitestenv.vnforapps.com/api.ordermgmt/api/v1/order/create/{merchantId}
Producción https://apiprod.vnforapps.com/api.ordermgmt/api/v1/order/create/{merchantId}
Ambiente
Testing
URL de API
https://apitestenv.vnforapps.com/api.ordermgmt/api/v1/order/create/{merchantId}
Producción
URL de API
https://apiprod.vnforapps.com/api.ordermgmt/api/v1/order/create/{merchantId}


C. Request y Casos

   C.1 Tabla de campos

Campo Tipo Longitud Obligatorio Descripción
PATH
merchantId Texto 9 SI Código de comercio creado al momento de la afiliación
HEADER
accessToken Texto Max 1000 SI Token generado con la API de Seguridad
BODY
externalId Texto Max 50 SI Identificador de la orden, generado por el comercio. Debe ser único.
orderType Texto Max 20 SI Tipo de orden: para pago por comercio electrónico es SINGLEPAY.
description Texto Max 200 SI Descripción de la orden.
expirationDate Texto 24 NO Fecha de expiración de la orden, debe ser una fecha mayor a la actual y no máximo de 30 días. Si no se envía, la orden vencerá en el tiempo configurado por default (en 5 días).
Formato GMT, enviar en este formato, este posteriormente convertirá la fecha a la zona horaria actual. Ejemplo: 2021-03-01T23:45:00-0000.
amount Decimal SI Monto de la orden.
customer NO Objeto para datos del cliente. Estos campos se pueden mostrar en el landing de la orden.
firstName Texto Max 50 NO Nombres del cliente
lastName Texto Max 50 NO Apellidos del cliente
email Texto Max 100 NO Correo electrónico del cliente
phoneNumber Texto Max 15 NO Número de celular del cliente
documentType Texto Max 11 NO Tipo de documento del cliente. Puede ser: NATIONAL_ID (DNI), RESIDENT_ID (Canet de extranjería), PASSPORT (Pasaporte)
documentNumber Texto Max 12 NO Número de documento del cliente
customData NO Objeto para parámetros adicionales que se pueden mostrar en la plantilla de Landing. El contenido del objeto es personalizable, desde los nombres de los campos hasta el valor de estos.

   C.2 Tabla de campos

Request

POST /api.ordermgmt/api/v1/order/create/341198210 HTTP/1.1

Host: apitestenv.vnforapps.com

Content-Type: application/json

Authorization:eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNP XC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJkMTlh M2I0Zi01NzYxLTRlYTEtYjBmYS1iNWNiNjU5OWQ5NWQiLCJjb2duaXRvOmdy b3VwcyI6WyJjdXN0b2RpbyJdLCJldmVudF9pZCI6IjAxNzcxYWQ5LWQzODktN GVlOC1hMDIwLTI0NmVmZWQ0NThhYSIsInRva2VuX3VzZSI6ImFjY2VzcyIsI nNjb3BlIjoiYXdzLmNvZ25pdG8uc2lnbmluLnVzZXIuYWRtaW4iLCJhdXRoX3 RpbWUiOjE2MDMwNTM4MjcsImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLWlkcC5 1cy1lYXN0LTEuYW1hem9uYXdzLmNvbVwvdXMtZWFzdC0xXzJjSjFTZTFmSSIs ImV4cCI6MTYwMzA1NzQyNywiaWF0IjoxNjAzMDUzODI3LCJqdGkiOiJlZDc3Y2 NjOS1kNjdlLTRhMDctOTljNC05YjgwZjBlYmYzNTUiLCJjbGllbnRfaWQiOiIx MGx2MDYxN281ZGljNTFlYnNucWVpaWpiNyIsInVzZXJuYW1lIjoiZ2lhbmNh Z2FsbGFyZG9AZ21haWwuY29tIn0.d0gjI5YB-v4FNSdTZTjFr2cpDAIq2CRRo mwb3oHuGHcju3oxvQH7hMWAfa2zHz911Lv4N4EAQ0Q_07A48ZPIEUaaHBGJVz aBFLaGHPL_H_Q2Y81PySfDQMzHhq6LvJ4IbYmhRc5Xw4WJYCWp9XbLJdm-I2p 4dsFN3-2aWgv1CvQ5bJliNUiSeNOpn6CMAeTl0NK-RprVr9ldGkVQDdnKaMT vxrSGQ-G4UYS01rBcBtWouWOSMMzJYly73wETBF9tJt9jW tWTm7DAdWFWn xA_ZPMo2LR6ps1FMgP0PsLbPqax5KkzB5uOeKKrIfkRT_L8nZgh_o3-PwTRY Pt_ng

{

 "externalId": "114934839245000000'",

 "orderType": "SINGLEPAY",

 "description": "Pago de Factura",

 "expirationDate": "2021-05-01T23:45:00-0000",

 "amount": 1.00,

 "customer": {

  "firstName": "test",

  "lastName": "test",

  "email": "testunico@gmail.com",

  "phoneNumber": "+51999999999",

  "documentType": "NATIONAL_ID",

  "documentNumber": "40116061"

 },

 "customData": {

  "nroFactura": "2021-05-123269",

  "direccion": "Av. Pardo 831",

  "colorFavorito": "azul"

 }

}

 


D. Response

   D.1 Tabla de campos

Campo Tipo Longitud Obligatorio Descripción
TRAMA PROCESADA: 200
batchId Texto Max 20 SI El valor por default que se le asigna es “ONLINE”.
externalId Texto Max 50 SI Identificador único de la orden, generada por el comercio.
orderId Texto 12 SI Identificador único de la orden, generado por Niubiz.
link Texto Max 58 SI Link de pago generado por Niubiz
status Texto Max 9 SI stado de la orden: PENDING (fue creada correctamente), FAILED (falló la petición en la creación por error de negocio). Una orden de solo puede usarse para una sola venta, si la orden fue procesada (pagada) no se podrá volver a utilizar. Pero si la orden se trató de pagar y salió denegada, la orden sigue abierta como PENDING
message Texto Max 500 SI Mensaje de respuesta.
TRAMA ERROR: 400, 500
responseCode Número 3 SI Solo aparece cuando es error 400 y 500. Puede ser 400 (comercio no existe), 500 (error del sistema).
responseMessage Texto Max 500 SI Descripción del error
data Objeto NO Objeto, viene vacío.
TRAMA ERROR: 401, 403
description Texto Max 1000 SI Descripción relacionada al error

   D.2 Tabla de campos

  • Caso 200 OK
  • Caso 400
  • Caso 401
  • Caso 403
  • Caso 500

Caso 200 – Orden exitosa:


Status Code 200 OK

Content-Type: application/json

{

 "batchId": "ONLINE",

 "externalId": "114934839245-81180988",

 "orderId": "A0ugDwYTP4MY",

 "link": "https://pagolinkniubiz.pe/pagoseguro/l/FCg3XmL8su6Q",

 "status": "PENDING",

 "message": "Successfully created"

}

Caso 200 – Orden fallida:


Status Code 200 OK

Content-Type: application/json

{

 "batchId": "ONLINE",

 "externalId": "114934839245-81180988",

 "status": "FAILED",

 "message": "Expiration date is not valid"

}



E. Códigos de Respuesta

Código Descripción
200 Petición procesada, puede ser exitosa o fallida de acuerdo con el estado de la orden.
400 Error en la generación de la orden (Cuando el comercio no existe o está inactivo o no fue configurado para usar esta solución).
401 Error, las credenciales utilizadas no son válidas.
403 Error, no tiene permitido usar esta API.
500 Cualquier otro tipo de error.

API de Creación de Orden en Batch #


A. Descripción y consideraciones

Esta API permitirá realizar la creación de un link de pago enviando una lista de órdenes en el request, se te responderá con unas URLs que podrás enviar a tu cliente y este al recibirlo podrá finalizar la transacción de venta; considerar que el envío de la URL no forma parte de esta solución. Para que esta API pueda resolver una operación necesita de un token de acceso vigente generado por el API de Seguridad.

El comercio afiliado debe asegurar que su integración (desarrollo) sea lo más segura posible aplicando las medidas preventivas que considere necesario.

Todas las invocaciones a las APIs (servicios backend) de Niubiz tienen que ser realizadas host to host.



B. Endpoint

Ambiente URL API
Testing https://apitestenv.vnforapps.com/api.ordermgmt/api/v1/order/create/{merchantId}/batch/{batchId}
Producción https://apiprod.vnforapps.com/api.ordermgmt/api/v1/order/create/{merchantId}/batch/{batchId}
Ambiente
Testing
URL de API
https://apitestenv.vnforapps.com/api.ordermgmt/api/v1/order/create/{merchantId}/batch/{batchId}
Producción
URL de API
https://apiprod.vnforapps.com/api.ordermgmt/api/v1/order/create/{merchantId}/batch/{batchId}


C. Request y Casos

  C.1 Tabla de campos

Campo Tipo Longitud Obligatorio Descripción
PATH
merchantId Texto 9 SI Código de comercio creado al momento de la afiliación
batchId Texto Max 20 SI Identificador del lote asignado por el comercio. Debe ser único.
HEADER
accessToken Texto Max 1000 SI Token generado con la API de Seguridad
BODY
Array SI Lista de órdenes
externalId Texto Max 50 SI Identificador de la orden, generado por el comercio. Debe ser único.
orderType Texto Max 20 SI Tipo de orden: para pago por comercio electrónico es SINGLEPAY.
description Texto Max 200 SI Descripción de la orden.
expirationDate Texto 24 NO Fecha de expiración de la orden, debe ser una fecha mayor a la actual y no máximo de 30 días. Si no se envía, la orden vencerá en el tiempo configurado por default (en 5 días).
Formato GMT, enviar en este formato, este posteriormente convertirá la fecha a la zona horaria actual. Ejemplo: 2021-03-01T23:45:00-0000.
amount Decimal SI Monto de la orden.
customer NO Objeto para datos del cliente. Estos campos se pueden mostrar en el landing de la orden.
firstName Texto Max 50 NO Nombres del cliente
lastName Texto Max 50 NO Apellidos del cliente
email Texto Max 100 NO Correo electrónico del cliente
phoneNumber Texto Max 15 NO Número de celular del cliente
documentType Texto Max 11 NO Tipo de documento del cliente. Puede ser: NATIONAL_ID (DNI), RESIDENT_ID (Canet de extranjería), PASSPORT (Pasaporte)
documentNumber Texto Max 12 NO Número de documento del cliente
customData NO Objeto para parámetros adicionales que se pueden mostrar en la plantilla de Landing. El contenido del objeto es personalizable, desde los nombres de los campos hasta el valor de estos.

  C.2 Trama de ejemplo:

Request

POST /api.ordermgmt/api/v1/order/create/341198210/batch/B0048 HTTP/1.1

Host: apitestenv.vnforapps.com

Content-Type: application/json

Authorization:eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjF hMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzd WIiOiJkMTlhM2I0Zi01NzYxLTRlYTEtYjBmYS1iNWNiNjU5OWQ5NWQi LCJjb2duaXRvOmdyb3VwcyI6WyJjdXN0b2RpbyJdLCJldmVudF9pZCI 6IjAxNzcxYWQ5LWQzODktNGVlOC1hMDIwLTI0NmVmZWQ0NThhYSIsIn Rva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiYXdzLmNvZ25pdG8uc 2lnbmluLnVzZXIuYWRtaW4iLCJhdXRoX3RpbWUiOjE2MDMwNTM4Mjcs ImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLWlkcC51cy1lYXN0LTEuYW1 hem9uYXdzLmNvbVwvdXMtZWFzdC0xXzJjSjFTZTFmSSIsImV4cCI6MT YwMzA1NzQyNywiaWF0IjoxNjAzMDUzODI3LCJqdGkiOiJlZDc3Y2NjOS 1kNjdlLTRhMDctOTljNC05YjgwZjBlYmYzNTUiLCJjbGllbnRfaWQiO iIxMGx2MDYxN281ZGljNTFlYnNucWVpaWpiNyIsInVzZXJuYW1lIjoi Z2lhbmNhZ2FsbGFyZG9AZ21haWwuY29tIn0.d0gjI5YB-v4FNSdTZTj Fr2cpDAIq2CRRomwb3oHuGHcju3oxvQH7hMWAfa2zHz911Lv4N4EAQ0 Q_07A48ZPIEUaaHBGJVzaBFLaGHPL_H_Q2Y81PySfDQMzHhq6LvJ4I bYmhRc5Xw4WJYCWp9XbLJdm-I2p4dsFN3-2aWgv1CvQ5bJliNUiSeNO pn6CMAeTl0NK-RprVr9ldGkVQDdnKaMTvxrSGQ-G4UYS01rBcBtWouW OSMMzJYly73wETBF9tJt9jWtWTm7DAdWFWnxA_ZPMo2LR6ps1FMgP0P sLbPqax5KkzB5uOeKKrIfkRT_L8nZgh_o3-PwTRYPt_ng

[

 {

  "externalId": "098987867679890989",

  "orderType": "SINGLEPAY",

  "description": "Pago de Factura",

  "expirationDate": "2021-05-01T12:10:59-0500",

  "amount": 10.12,

  "customData": {

   "p1": "v1",

   "p2": "v2"

  },

  "customer": {

   "firstName": "test",

   "lastName": "test",

   "email": "test@gmail.com",

   "phoneNumber": "+51999333111"

  }

 },

 {

  "externalId": "098987867679890989",

  "orderType": "SINGLEPAY",

  "description": "Pago de factura",

  "amount": 100,

  "customer": {

   "phoneNumber": "+51999333111"

  }

 }

]



D. Response

  D.1 Tabla de Parámetros:

Campo Tipo Longitud Obligatorio Descripción
TRAMA PROCESADA: 200
Array SI Lista de resultados de las órdenes
batchId Texto Max 20 SI Identificador del lote asignado por el comercio. Debe ser único.
externalId Texto Max 50 SI Identificador único de la orden, generada por el comercio.
orderId Texto 12 SI Identificador único de la orden, generado por Niubiz.
link Texto Max 58 SI Link de pago generado por Niubiz
status Texto Max 11 SI Estado de la orden: PENDING (fue creada correctamente), FAILED (falló la petición en la creación por error de negocio). Una orden de solo puede usarse para una sola venta, si la orden fue procesada (pagada) no se podrá volver a utilizar. Pero si la orden se trató de pagar y salió denegada, la orden sigue abierta como PENDING
message Texto Max 500 SI Mensaje de respuesta.
TRAMA ERROR: 400, 500
responseCode Número 3 SI Solo aparece cuando es error 400 y 500. Puede ser 400 (comercio no existe o lote es duplicado), 500 (error del sistema).
responseMessage Texto Max 500 SI Descripción del error
data Objeto NO Objeto, viene vacío.
TRAMA ERROR: 401, 403
description Texto Max 1000 SI Descripción relacionada al error

   D.2 Tramas de ejemplo

  • Caso 200
  • Caso 400
  • Caso 401
  • Caso 403
  • Caso 500

Status Code 200 OK

Content-Type: application/json

[

 {

  "batchId": "B0048",

  "externalId": "098987867679890989",

  "status": "FAILED",

  "message": "Expiration date is not valid"

 },

 {

  "batchId": "B0048",

  "externalId": "43e0d5da-1cbf-4aed-b579-bdc49b6f14c2",

  "orderId": "xW3pLc3qoSxY",

  "link": " https://pagolinkniubiz.pe/pagoseguro/l/xW3pLc3qoSxY",

  "status": "PENDING",

  "message": "Successfully created"

 }

]



E. Códigos de Respuesta

Código Descripción
200 Petición procesada, puede ser exitosa o fallida de acuerdo con el estado de la orden.
400 Error en la generación de la orden (Cuando el comercio no existe o está inactivo o no fue configurado para usar esta solución, también aplica si el lote está duplicado).
401 Error, las credenciales utilizadas no son válidas.
403 Error, no tiene permitido usar esta API.
500 Cualquier otro tipo de error.

API de Consulta por ID #


A. Descripción y consideraciones

Esta API permitirá consultar una orden por el identificador que generó Niubiz en el momento de la creación de la orden. Para que esta API pueda resolver una operación necesita de un token de acceso vigente generado por el API de Seguridad.

El comercio afiliado debe asegurar que su integración (desarrollo) sea lo más segura posible aplicando las medidas preventivas que considere necesario.

Todas las invocaciones a las APIs (servicios backend) de Niubiz tienen que ser realizadas host to host.



B. Endpoint

Ambiente URL API
Testing https://apitestenv.vnforapps.com/api.ordermgmt/api/v1/order/create/{merchantId}/batch/{batchId}
Producción https://apiprod.vnforapps.com/api.ordermgmt/api/v1/order/create/{merchantId}/batch/{batchId}
Ambiente
Testing
URL de API
https://apitestenv.vnforapps.com/api.ordermgmt/api/v1/order/query/{merchantId}/{orderId}
Producción
URL de API
https://apiprod.vnforapps.com/api.ordermgmt/api/v1/order/query/{merchantId}/{orderId}


C. Request y Casos

  C.1 Tabla de campos

Campo Tipo Longitud Obligatorio Descripción
PATH
merchantId Texto 9 SI Código de comercio creado al momento de la afiliación
orderId Texto Max 12 SI Identificador único de la orden, generado por Niubiz.
HEADER
accessToken Texto Max 1000 SI Token generado con la API de Seguridad

  C.2 Tabla de campos

Request

GET /api.ordermgmt/api/v1/order/query/341198210/inb6azAXRcWG HTTP/1.1

Host: apitestenv.vnforapps.com

Content-Type: application/json

Authorization:eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnN PXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJkMTlh M2I0Zi01NzYxLTRlYTEtYjBmYS1iNWNiNjU5OWQ5NWQiLCJjb2duaXRvOmdy b3VwcyI6WyJjdXN0b2RpbyJdLCJldmVudF9pZCI6IjAxNzcxYWQ5LWQzODkt NGVlOC1hMDIwLTI0NmVmZWQ0NThhYSIsInRva2VuX3VzZSI6ImFjY2VzcyIsI nNjb3BlIjoiYXdzLmNvZ25pdG8uc2lnbmluLnVzZXIuYWRtaW4iLCJhdXRoX3 RpbWUiOjE2MDMwNTM4MjcsImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLWlkcC5 1cy1lYXN0LTEuYW1hem9uYXdzLmNvbVwvdXMtZWFzdC0xXzJjSjFTZTFmSSI sImV4cCI6MTYwMzA1NzQyNywiaWF0IjoxNjAzMDUzODI3LCJqdGkiOiJlZDc3Y 2NjOS1kNjdlLTRhMDctOTljNC05YjgwZjBlYmYzNTUiLCJjbGllbnRfaWQiO iIxMGx2MDYxN281ZGljNTFlYnNucWVpaWpiNyIsInVzZXJuYW1lIjoiZ2lhbm NhZ2FsbGFyZG9AZ21haWwuY29tIn0.d0gjI5YB-v4FNSdTZTjFr2cpDAIq2CR Romwb3oHuGHcju3oxvQH7hMWAfa2zHz911Lv4N4EAQ0Q_07A48ZPIEUaaHBGJ VzaBFLaGHPL_H_Q2Y81PySfDQMzHhq6LvJ4IbYmhRc5Xw4WJYCWp9XbLJdm-I 2p4dsFN3-2aWgv1CvQ5bJliNUiSeNOpn6CMAeTl0NK-RprVr9ldGkVQDdnKa MTvxrSGQ-G4UYS01rBcBtWouWOSMMzJYly73wETBF9tJt9jW tWTm7DAdWFW nxA_ZPMo2LR6ps1FMgP0PsLbPqax5KkzB5uOeKKrIfkRT_L8nZgh_o3-PwTR YPt_ng



D. Response:

  D.1 Tabla de campos

Campo Tipo Longitud Obligatorio Descripción
TRAMA PROCESADA: 200
merchantId Texto 9 SI Código de comercio creado al momento de la afiliación
batchId Texto Max 20 SI Identificador del lote asignado por el comercio. Debe ser único.
orderId Texto 12 SI Identificador único de la orden, generado por Niubiz.
externalId Texto Max 50 SI Identificador de la orden, generado por el comercio. Debe ser único.
orderType Texto Max 20 SI Tipo de orden: para pago por comercio electrónico es SINGLEPAY.
description Texto Max 200 SI Descripción de la orden.
expirationDate Texto 24 SI Fecha de expiración de la orden, debe ser una fecha mayor a la actual y no máximo de 30 días. Si no se envía, la orden vencerá en el tiempo configurado por default (en 5 días). Formato GMT, enviar en este formato, este posteriormente convertirá la fecha a la zona horaria actual. Ejemplo: 2021-03-01T23:45:00-0000.
amount Decimal SI Monto de la orden.
customer NO Objeto para datos del cliente. Estos campos se pueden mostrar en el landing de la orden.
firstName Texto Max 50 NO Nombres del cliente
lastName Texto Max 50 NO Apellidos del cliente
email Texto Max 100 NO Correo electrónico del cliente
phoneNumber Texto Max 15 NO Número de celular del cliente
documentType Texto Max 11 NO Tipo de documento del cliente. Puede ser: NATIONAL_ID (DNI), RESIDENT_ID (Canet de extranjería), PASSPORT (Pasaporte)
documentNumber Texto Max 12 NO Número de documento del cliente
status Texto Max 9 SI El campo “status” puede ser:
PENDING: Ordenes nuevas que aún no han sido procesadas de forma exitosa.
COMPLETED: Ordenes que ya han sido pagadas de forma exitosa.
CANCELED: Ordenes que han sido anuladas.
EXPIRED: Ordenes que han expirado.
link Texto Max 58 SI Link de pago generado por Niubiz
createdOn Texto Max 50 SI Usuario que realizó la creación del link
modifiedOn Texto Max 50 NO Usuario que realizó alguna modificación
createdBy Datetime 13 SI Fecha de creación en formato UNIX. Ejemplo: 1613511941000
modifiedBy Datetime 13 NO Fecha de modificación en formato UNIX. Ejemplo: 1613511941000
TRAMA ERROR: 400, 500
responseCode Número 3 SI Solo aparece cuando es error 400 y 500. Puede ser 400 (comercio no existe o lote es duplicado), 500 (error del sistema).
responseMessage Texto Max 500 SI Descripción del error
data Objeto NO Objeto, viene vacío.
TRAMA ERROR: 401, 403
description Texto Max 1000 SI Descripción relacionada al error

  D.2 Tramas de ejemplo

  • Caso 200
  • Caso 400
  • Caso 401
  • Caso 403
  • Caso 500

Status Code 200 OK

Content-Type: application/json

{

 "merchantId": "341198210",

 "batchId": "B0048",

 "orderId": "xW3pLc3qoSxY",

 "orderType": "SINGLEPAY",

 "description": "Prueba 6",

 "expirationDate": 1613943942000,

 "amount": 100.00,

 "customer": {

  "phoneNumber": "+51999333111"

 },

 "externalId": "43e0d5da-1cbf-4aed-b579-bdc49b6f14c2",

 "status": "PENDING",

 "link": " https://pagolinkniubiz.pe/pagoseguro/l/xW3pLc3qoSxY",

 "currencyId": "PEN",

 "createdOn": 1613511941000,

 "modifiedOn": 1613511941000,

 "createdBy": "user@gmail.com",

 "modifiedBy": "user@gmail.com"

}



E. Códigos de Respuesta

Código Descripción
200 Petición procesada, puede ser exitosa o fallida de acuerdo con el estado de la orden.
400 Error en la consulta de la orden.
401 Error, las credenciales utilizadas no son válidas.
403 Error, no tiene permitido usar esta API.
500 Cualquier otro tipo de error.

API de Consulta por External ID #


A. Descripción y consideraciones

Esta API permitirá consultar una orden por el identificador enviado por el comercio en el momento de la creación de la orden. Para que esta API pueda resolver una operación necesita de un token de acceso vigente generado por el API de Seguridad.

El comercio afiliado debe asegurar que su integración (desarrollo) sea lo más segura posible aplicando las medidas preventivas que considere necesario.

Todas las invocaciones a las APIs (servicios backend) de Niubiz tienen que ser realizadas host to host.



B. Endpoint

Ambiente URL API
Testing https://apitestenv.vnforapps.com/api.ordermgmt/api/v1/order/query/{merchantId}/external/{externalId}
Producción https://apiprod.vnforapps.com/api.ordermgmt/api/v1/order/query/{merchantId}/external/{externalId}
Ambiente
Testing
URL de API
https://apitestenv.vnforapps.com/api.ordermgmt/api/v1/order/query/{merchantId}/external/{externalId}
Producción
URL de API
https://apiprod.vnforapps.com/api.ordermgmt/api/v1/order/query/{merchantId}/external/{externalId}


C. Request y Casos

  C.1 Tabla de campos

Campo Tipo Longitud Obligatorio Descripción
PATH
merchantId Texto 9 SI Código de comercio creado al momento de la afiliación
externalId Texto Max 50 SI Identificador único de la orden, generado por el comercio.
HEADER
accessToken Texto Max 1000 SI Token generado con la API de Seguridad

  C.2 Trama de ejemplo:

Request

GET /api.ordermgmt/api/v1/order/query/341198210/external/43e0d5da-1cbf-4aed-b579-bdc49b6f14c2 HTTP/1.1

Host: apitestenv.vnforapps.com

Content-Type: application/json

Authorization:eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMn NPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJk MTlhM2I0Zi01NzYxLTRlYTEtYjBmYS1iNWNiNjU5OWQ5NWQiLCJjb2duaXR vOmdyb3VwcyI6WyJjdXN0b2RpbyJdLCJldmVudF9pZCI6IjAxNzcxYWQ5L WQzODktNGVlOC1hMDIwLTI0NmVmZWQ0NThhYSIsInRva2VuX3VzZSI6ImFj Y2VzcyIsInNjb3BlIjoiYXdzLmNvZ25pdG8uc2lnbmluLnVzZXIuYWRtaW4 iLCJhdXRoX3RpbWUiOjE2MDMwNTM4MjcsImlzcyI6Imh0dHBzOlwvXC9jb2 duaXRvLWlkcC51cy1lYXN0LTEuYW1hem9uYXdzLmNvbVwvdXMtZWFzdC0xX zJjSjFTZTFmSSIsImV4cCI6MTYwMzA1NzQyNywiaWF0IjoxNjAzMDUzODI3 LCJqdGkiOiJlZDc3Y2NjOS1kNjdlLTRhMDctOTljNC05YjgwZjBlYmYzNTU iLCJjbGllbnRfaWQiOiIxMGx2MDYxN281ZGljNTFlYnNucWVpaWpiNyIsI nVzZXJuYW1lIjoiZ2lhbmNhZ2FsbGFyZG9AZ21haWwuY29tn0.d0gjI5YB- v4FNSdTZTjFr2cpDAIq2CRRomwb3oHuGHcju3oxvQH7hMWAfa2zHz911Lv4 N4EAQ0Q_07A48ZPIEUaaHBGJVzaBFLaGHPL_H_Q2Y81PySfDQMzHhq6LvJ4 IbYmhRc5Xw4WJYCWp9XbLJdm-I2p4dsFN3-2aWgv1CvQ5bJliNUiSeNOpn6 CMAeTl0NK-RprVr9ldGkVQDdnKaMTvxrSGQ-G4UYS01rBcBtWouWOSMMzJY ly73wETBF9tJt9jW tWTm7DAdWFWnxA_ZPMo2LR6ps1FMgP0PsLbPqax5Kk zB5uOeKKrIfkRT_L8nZgh_o3-PwTRYPt_ng



D. Response:

  D.1 Tabla de campos

Campo Tipo Longitud Obligatorio Descripción
TRAMA PROCESADA: 200
merchantId Texto 9 SI Código de comercio creado al momento de la afiliación
batchId Texto Max 20 SI Identificador del lote asignado por el comercio. Debe ser único.
orderId Texto 12 SI Identificador único de la orden, generado por Niubiz.
externalId Texto Max 50 SI Identificador de la orden, generado por el comercio. Debe ser único.
orderType Texto Max 20 SI Tipo de orden: para pago por comercio electrónico es SINGLEPAY.
description Texto Max 200 SI Descripción de la orden.
expirationDate Texto 24 SI Fecha de expiración de la orden, debe ser una fecha mayor a la actual y no máximo de 30 días. Si no se envía, la orden vencerá en el tiempo configurado por default (en 5 días). Formato GMT, enviar en este formato, este posteriormente convertirá la fecha a la zona horaria actual. Ejemplo: 2021-03-01T23:45:00-0000.
amount Decimal SI Monto de la orden.
customer NO Objeto para datos del cliente. Estos campos se pueden mostrar en el landing de la orden.
firstName Texto Max 50 NO Nombres del cliente
lastName Texto Max 50 NO Apellidos del cliente
email Texto Max 100 NO Correo electrónico del cliente
phoneNumber Texto Max 15 NO Número de celular del cliente
documentType Texto Max 11 NO Tipo de documento del cliente. Puede ser: NATIONAL_ID (DNI), RESIDENT_ID (Canet de extranjería), PASSPORT (Pasaporte)
documentNumber Texto Max 12 NO Número de documento del cliente
status Texto Max 9 SI El campo “status” puede ser:
PENDING: Ordenes nuevas que aún no han sido procesadas de forma exitosa.
COMPLETED: Ordenes que ya han sido pagadas de forma exitosa.
CANCELED: Ordenes que han sido anuladas.
EXPIRED: Ordenes que han expirado.
link Texto Max 58 SI Link de pago generado por Niubiz
createdOn Texto Max 50 SI Usuario que realizó la creación del link
modifiedOn Texto Max 50 NO Usuario que realizó alguna modificación
createdBy Datetime 13 SI Fecha de creación en formato UNIX. Ejemplo: 1613511941000
modifiedBy Datetime 13 NO Fecha de modificación en formato UNIX. Ejemplo: 1613511941000
TRAMA ERROR: 400, 500
responseCode Número 3 SI Solo aparece cuando es error 400 y 500. Puede ser 400 (comercio no existe o lote es duplicado), 500 (error del sistema).
responseMessage Texto Max 500 SI Descripción del error
data Objeto NO Objeto, viene vacío.
TRAMA ERROR: 401, 403
description Texto Max 1000 SI Descripción relacionada al error

  D.2 Tramas de ejemplo

  • Caso 200
  • Caso 400
  • Caso 401
  • Caso 403
  • Caso 500

Status Code 200 OK

Content-Type: application/json

{

 "merchantId": "341198210",

 "batchId": "B0048",

 "orderId": "xW3pLc3qoSxY",

 "orderType": "SINGLEPAY",

 "description": "Prueba 6",

 "expirationDate": 1613943942000,

 "amount": 100.00,

 "customer": {

  "phoneNumber": "+51999333111"

 },

 "externalId": "43e0d5da-1cbf-4aed-b579-bdc49b6f14c2",

 "status": "PENDING",

 "link": " https://pagolinkniubiz.pe/pagoseguro/l/xW3pLc3qoSxY",

 "currencyId": "PEN",

 "createdOn": 1613511941000,

 "modifiedOn": 1613511941000,

 "createdBy": "user@gmail.com",

 "modifiedBy": "user@gmail.com"

}



E. Códigos de Respuesta

Código Descripción
200 Petición procesada, puede ser exitosa o fallida de acuerdo con el estado de la orden.
400 Error en la consulta de la orden.
401 Error, las credenciales utilizadas no son válidas.
403 Error, no tiene permitido usar esta API.
500 Cualquier otro tipo de error.

API de Consulta por Batch #


A. Descripción y consideraciones

Esta API permitirá consultar una o varias órdenes por el identificador del lote enviado por el comercio en el momento de la creación de la orden. Para que esta API pueda resolver una operación necesita de un token de acceso vigente generado por el API de Seguridad.

El comercio afiliado debe asegurar que su integración (desarrollo) sea lo más segura posible aplicando las medidas preventivas que considere necesario.

Todas las invocaciones a las APIs (servicios backend) de Niubiz tienen que ser realizadas host to host.



B. Endpoint

Ambiente URL API
Testing https://apitestenv.vnforapps.com/api.ordermgmt/api/v1/batch/query/{merchantId}/{batchId}
Producción https://apiprod.vnforapps.com/api.ordermgmt/api/v1/batch/query/{merchantId}/{batchId}
Ambiente
Testing
URL de API
https://apitestenv.vnforapps.com/api.ordermgmt/api/v1/batch/query/{merchantId}/{batchId}
Producción
URL de API
https://apiprod.vnforapps.com/api.ordermgmt/api/v1/batch/query/{merchantId}/{batchId}


C. Request y Casos

  C.1 Tabla de campos

Campo Tipo Longitud Obligatorio Descripción
PATH
merchantId Texto 9 SI Código de comercio creado al momento de la afiliación
batchId Texto Max 20 SI Identificador único del lote generado por el comercio.
HEADER
accessToken Texto Max 1000 SI Token generado con la API de Seguridad

  C.2 Trama de ejemplo:

Request

GET /api.ordermgmt/api/v1/order/batch/query/341198210/B0048 HTTP/1.1

Host: apitestenv.vnforapps.com

Content-Type: application/json

Authorization:eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnN PXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJkM TlhM2I0Zi01NzYxLTRlYTEtYjBmYS1iNWNiNjU5OWQ5NWQiLCJjb2duaXRv Omdyb3VwcyI6WyJjdXN0b2RpbyJdLCJldmVudF9pZCI6IjAxNzcxYWQ5LWQ zODktNGVlOC1hMDIwLTI0NmVmZWQ0NThhYSIsInRva2VuX3VzZSI6ImFjY2 VzcyIsInNjb3BlIjoiYXdzLmNvZ25pdG8uc2lnbmluLnVzZXIuYWRtaW4iL CJhdXRoX3RpbWUiOjE2MDMwNTM4MjcsImlzcyI6Imh0dHBzOlwvXC9jb2d uaXRvLWlkcC51cy1lYXN0LTEuYW1hem9uYXdzLmNvbVwvdXMtZWFzdC0xXz JjSjFTZTFmSSIsImV4cCI6MTYwMzA1NzQyNywiaWF0IjoxNjAzMDUzODI3 LCJqdGkiOiJlZDc3Y2NjOS1kNjdlLTRhMDctOTljNC05YjgwZjBlYmYzNT UiLCJjbGllbnRfaWQiOiIxMGx2MDYxN281ZGljNTFlYnNucWVpaWpiNyIs InVzZXJuYW1lIjoiZ2lhbmNhZ2FsbGFyZG9AZ21haWwuY29tIn0.d0gjI5 YB-v4FNSdTZTjFr2cpDAIq2CRRomwb3oHuGHcju3oxvQH7hMWAfa2zHz91 1Lv4N4EAQ0Q_07A48ZPIEUaaHBGJVzaBFLaGHPL_H_Q2Y81PySfDQMzHh q6LvJ4IbYmhRc5Xw4WJYCWp9XbLJdm-I2p4dsFN3-2aWgv1CvQ5bJliNUi SeNOpn6CMAeTl0NK-RprVr9ldGkVQDdnKaMTvxrSGQ-G4UYS01rBcBtWou WOSMMzJYly73wETBF9tJt9jW tWTm7DAdWFWnxA_ZPMo2LR6ps1FMgP0PsL bPqax5KkzB5uOeKKrIfkRT_L8nZgh_o3-PwTRYPt_ng



D. Response:

  D.1 Tabla de campos

Campo Tipo Longitud Obligatorio Descripción
TRAMA PROCESADA: 200
batchId Texto 6 SI Identificador del lote asignado por el comercio. Debe ser único.
orderId Texto 12 SI dentificador único de la orden, generado por Niubiz.
externalId Texto Max 50 SI Identificador de la orden, generado por el comercio. Debe ser único.
status Texto Max 9 SI El campo “status” puede ser:
PENDING: Ordenes nuevas que aún no han sido procesadas de forma exitosa.
COMPLETED: Ordenes que ya han sido pagadas de forma exitosa.
CANCELED: Ordenes que han sido anuladas.
EXPIRED: Ordenes que han expirado.
link Texto Max 58 SI Link de pago generado por Niubiz
TRAMA ERROR: 400, 500
responseCode Número 3 SI Solo aparece cuando es error 400 y 500. Puede ser 400 (comercio no existe o lote es duplicado), 500 (error del sistema).
responseMessage Texto Max 500 SI Descripción del error
data Objeto NO Objeto, viene vacío.
TRAMA ERROR: 401, 403
description Texto Max 1000 SI Descripción relacionada al error

  D.2 Tramas de ejemplo

  • Caso 200
  • Caso 400
  • Caso 401
  • Caso 403
  • Caso 500

Status Code 200 OK

Content-Type: application/json

[

 {

  "batchId": "B0048",

  "externalId": "43e0d5da-1cbf-4aed-b579-bdc49b6f14c2",

  "orderId": "xW3pLc3qoSxY",

  "link": " https://pagolinkniubiz.pe/pagoseguro/l/xW3pLc3qoSxY",

  "status": "PENDING"

 }

]



E. Códigos de Respuesta

Código Descripción
200 Petición procesada, puede ser exitosa o fallida de acuerdo con el estado de la orden.
400 Error en la consulta de la orden.
401 Error, las credenciales utilizadas no son válidas.
403 Error, no tiene permitido usar esta API.
500 Cualquier otro tipo de error.

API de Anulación de Orden #


A. Descripción y consideraciones

Esta API permitirá anular un orden que está en estado PENDIENTE enviando el identificador de la orden generado por Niubiz. Considerar que solo se estará anulando la orden no procesada, una vez que fue procesada y ejecutado el pago, no se podrá anular, tampoco aplica para anulaciones de pagos como tal. Para que esta API pueda resolver una operación necesita de un token de acceso vigente generado por el API de Seguridad.

El comercio afiliado debe asegurar que su integración (desarrollo) sea lo más segura posible aplicando las medidas preventivas que considere necesario.

Todas las invocaciones a las APIs (servicios backend) de Niubiz tienen que ser realizadas host to host.



B. Endpoint

Ambiente URL API
Testing https://apitestenv.vnforapps.com/api.ordermgmt/api/v1/order/cancel/{merchantId}/{orderId}
Producción https://apiprod.vnforapps.com/api.ordermgmt/api/v1/order/cancel/{merchantId}/{orderId}
Ambiente
Testing
URL de API
https://apitestenv.vnforapps.com/api.ordermgmt/api/v1/order/cancel/{merchantId}/{orderId}
Producción
URL de API
https://apiprod.vnforapps.com/api.ordermgmt/api/v1/order/cancel/{merchantId}/{orderId}


C. Request y Casos

  C.1 Tabla de campos

Campo Tipo Longitud Obligatorio Descripción
PATH
merchantId Texto 9 SI Código de comercio creado al momento de la afiliación
orderId Texto Max 12 SI Identificador único de la orden, generado por Niubiz
HEADER
accessToken Texto Max 1000 SI Token generado con la API de Seguridad

  C.2 Tabla de campos

Request

DELETE /api.ordermgmt/api/v1/order/341198214/9I8fp0hcLjK4 HTTP/1.1

Host: apitestenv.vnforapps.com

Content-Type: application/json

Authorization:eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9z QnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJkMTlhM2I0Zi01 NzYxLTRlYTEtYjBmYS1iNWNiNjU5OWQ5NWQiLCJjb2duaXRvOmdyb3VwcyI6WyJj dXN0b2RpbyJdLCJldmVudF9pZCI6IjAxNzcxYWQ5LWQzODktNGVlOC1hMDIwLTI0 NmVmZWQ0NThhYSIsInRva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiYXdzLmNv Z25pdG8uc2lnbmluLnVzZXIuYWRtaW4iLCJhdXRoX3RpbWUiOjE2MDMwNTM4Mjcs ImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLWlkcC51cy1lYXN0LTEuYW1hem9uYXdzLm NvbVwvdXMtZWFzdC0xXzJjSjFTZTFmSSIsImV4cCI6MTYwMzA1NzQyNywiaWF0Ijo xNjAzMDUzODI3LCJqdGkiOiJlZDc3Y2NjOS1kNjdlLTRhMDctOTljNC05YjgwZjBl YmYzNTUiLCJjbGllbnRfaWQiOiIxMGx2MDYxN281ZGjNTFlYnNucWVpaWpiNyIsIn VzZXJuYW1lIjoiZ2lhbmNhZ2FsbGFyZG9AZ21haWwuY29tIn0.d0gjI5YB-v4FNSdT ZTjFr2cpDAIq2CRRomwb3oHuGHcju3oxvQH7hMWAfa2zHz911Lv4N4EAQ0Q_07A48 ZPIEUaaHBGJVzaBFLaGHPL_H_Q2Y81PySfDQMzHhq6LvJ4IbYmhRc5Xw4WJYCWp9X bLJdm-I2p4dsFN3-2aWgv1CvQ5bJliNUiSeNOpn6CMAeTl0NK-RprVr9ldGkVQDdn KaMTvxrSGQ-G4UYS01rBcBtWouWOSMMzJYly73wETBF9tJt9jW tWTm7DAdWFWnx A_ZPMo2LR6ps1FMgP0PsLbPqax5KkzB5uOeKKrIfkRT_L8nZgh_o3-PwTRYPt_ng



D. Response:

  D.1 Tabla de campos

Campo Tipo Longitud Obligatorio Descripción
TRAMAS: 200, 404, 401, 403, 500
description Texto Max 1000 SI Descripción relacionada al estado. Considerar que solo se devolverá un header response sin trama adicional.

  D.2 Tramas de ejemplo

  • Caso 200
  • Caso 401
  • Caso 403
  • Caso 404
  • Caso 500

Status Code 200 OK

Content-Type: application/json



E. Códigos de Respuesta

Código Descripción
200 Anulación exitosa.
401 Error, las credenciales utilizadas no son válidas.
403 Error, no tiene permitido usar esta API.
404 Error, no procedió la anulación
500 Cualquier otro tipo de error.

Data de Pruebas #

Te dejamos aquí lo que necesitas para realizar tus pruebas.

Códigos de comercio

Código de comercio Moneda Tipo Liquidación
456879852 Soles Liquidación automática
456879856 Soles Liquidación manual
456879853 Dólares Liquidación automática
456879854 Dólares Liquidación manual
 

Las credenciales que debes utilizar serán las siguientes:

 
Usuario Password
integraciones@niubiz.com.pe _7z3@8fF

Certificación y pase a producción #


A continuación te mostraremos los pasos resumen que debes tener en cuenta para tu Certificación y Pase a Producción.


Revisa y valida el CheckList de Certificación.
Debes contar con un Código de Comercio en producción.
Coordina la fecha de tu Certificación.
  • Código de comercio
  • Datos de la persona que realizará las pruebas de certificación (Nombre, teléfono y correo)
  • 3 fechas tentativas y horarios (L a V de 9am a 6pm)
Coordina tu Pase a Producción.
  • Durante la certificación podrás realizar el pase a producción o programarlo con un tiempo máximo de 5 días útiles.
  • Durante el pase a producción, revisaremos cada uno de lo puntos que se detallan en Pasos para tu Pase a Producción.


¡Luego de culminar la certificación y puesta en producción, estás listo para empezar a vender!


Checklist de certificación


Requisitos obligatorios que debes considerar:


Validar caso exitoso.
  • Debes revisar la trama de respuesta, el código de acción 200 y que el resultado sea el esperado.
Validar caso Fallido.
  • Debes revisar la trama de respuesta, el código de acción 400 y que el resultado sea el esperado (por ejemplo pruebas con tarjetas vencidas o cvv incorrecto).
Términos y Condiciones.
  • Divulgar los términos y condiciones.
  • En la secuencia de las páginas finales antes del checkout, y debe incluir un “clic para aceptar”, una casilla u otro botón de aceptación, o lugar para una firma electrónica, o
  • En la pantalla final de pago cerca del botón “Enviar”.
  • En un pop up o enlace, cuya lectura y aceptación a través de un check box sea obligatoria en la misma página del checkout antes que el tarjetahabiente acepte la compra.
  • Considerar la casilla de aceptación de términos y condiciones no debe de estar premarcardo.


Pasos para el pase a producción:


Considera los siguientes pasos para tu pase a producción:


Validar caso exitoso.
  • Debes revisar la trama de respuesta, el código de acción 200 y que el resultado sea el esperado.
Validar caso Fallido.
  • Debes revisar la trama de respuesta, el código de acción 400 y que el resultado sea el esperado (por ejemplo pruebas con tarjetas vencidas o cvv incorrecto).
Suggest Edit