simulate-payment-order
Este método se utiliza para simular el pago de órdenes de venta, se puede simular el pago proveniente de un usuario de MercadoBits y el pago proveniente de una wallet externa (donde se requieren confirmaciones de red), es muy útil para revisar el comportamiento y los estados de una orden a medida que se realizan pagos parciales o un pago completo.
NOTAS
Este método solo está disponible para el ambiente SANDBOX DE PRUEBAS por lo que no será posible utilizarlo en el ambiente de PRODUCCION.
Path del método
simulate-payment-order
Endpoint final
SANDBOX DE PRUEBAS
https://sandbox.aceptabits.com/api/thirdparty/v1/simulate-payment-order
Método de petición HTTP
POST
Lista de parámetros
| Parámetro | Obligatorio | Descripción | valor |
|---|---|---|---|
| code | Si | El código de la orden de venta que se quiere pagar | Ejemplo: pgbord140375571995812256 Deberás de ingresar el código de la tienda que a la que requieres simular el pago |
| amount | Si | Es la cantidad que simulara el depósito a la dirección de la orden | Ejemplo: 0.005, 120, 300.55632 Deberás de ingresar la cantidad que requieres que se pague a la orden de venta, este valor deberá de ser numérico y con un máximo de 8 decimales La cantidad queda limitada a los siguientes valores siempre y cuando se utilice el parámetro type con valor igual a 2 (simular un depósito proveniente de una wallet externa y que requiere confirmaciones de red):* máximo 1000 para la moneda PesoBits (PBT) * máximo 1 para la moneda Bitcoin (BTC) Es decir, que solo podrás enviar máximo estos valores cada vez que ejecutes este método, por ejemplo: si quieres pagar una orden de venta de 1500 PesoBits deberías de ejecutar este método dos veces (una por 1000 PBT y otra por 500 PBT o una por 800 PBT y otra por 700 PBT o como requieras hacerlo pero respetando el máximo posible en cada llamada) Cuando se utilice el parámetro type con valor igual a 1 (simular un depósito proveniente de un usuario de MercadoBits) no se tendrá la restricción en la cantidad como si lo es en el caso anterior, por lo que podrás enviar la cantidad necesaria que requieras simularSe recomienda que las órdenes de venta generadas sean lo más realistas posibles para que desarrollador pueda revisar su comportamiento de una mejor manera |
| type | Si | Indica el tipo de depósito | Se aceptan dos valores el 1 y el 2: 1 = simula el depósito proveniente de un usuario de MercadoBits (se refleja de manera inmediate). 2 = simula el depósito proveniente de una wallet externa (requiere X número de confirmaciones de red). Este parámetro representara la naturaleza del monto enviado en el parámetro amount, para saber más acerca de los estados y el comportamiento de una orden dependiendo de cada tipo de depósito consulte la documentación de: add-order, show-order, get-orders o show-order-customer |
NOTAS
Este método solo funciona con órdenes que ya han sido abiertas al cliente, es decir, después de ser abiertas con el método show-order-customer, esto es debido a que las órdenes que no ha sido ejecutadas en este método no tendrán generada su respectiva dirección de deposito
Lista de códigos
Exitoso
| Código | Descripción |
|---|---|
| 0108 | El pago de la orden se ha simulado con éxito |
Error
| Código | Descripción |
|---|---|
| 0000 | El Token API no es correcto y la autenticación del usuario ha fallado |
| 0003 | El Token API no es correcto y la autenticación del usuario ha fallado |
| 1630 | El Token API no es correcto y la autenticación del usuario ha fallado |
| 1631 | El código del orden es requerido |
| 1632 | La cantidad que simulara el depósito es requerido |
| 1633 | La cantidad que simulara el depósito debe de ser numérico, mayor a 0 y con máximo 8 decimales |
| 1634 | La cantidad que simulara el depósito debe de ser numérico, mayor a 0 y con máximo 8 decimales |
| 1635 | El tipo de depósito es requerido |
| 1636 | El tipo de depósito debe de ser 1 o 2 |
| 1637 | El tipo de depósito debe de ser 1 o 2 |
| 1638 | El tipo de depósito debe de ser 1 o 2 |
| 1639 | La orden de venta que se intenta pagar no existe (el código de orden es incorrecto) |
| 1640 | La orden aún no ha generado su dirección de depósito |
| 1641 | La orden ya se encuentra como pagada |
| 1642 | La orden ha expirado |
| 1643 | La orden ha expirado |
| 1644 | La cantidad que simulara el depósito debe de ser numérico, mayor a 0 y con máximo 8 decimales |
| 1645 | El monto no puede exceder de 1 BTC para simular el pago |
| 1646 | Ocurrió un problema al simular el pago de la orden de venta por medio de wallet externa (deposito con confirmaciones de red), inténtelo nuevamente o consulte con soporte técnico para más ayuda |
| 1647 | El monto para simular el pago por medio de wallet externa (deposito con confirmaciones de red) es muy pequeño, ingrese una cantidad más alta |
| 1648 | Ocurrió un problema al simular el pago de la orden de venta por medio de wallet externa (deposito con confirmaciones de red), inténtelo nuevamente o consulte con soporte técnico para más ayuda |
| 1649 | El monto no puede exceder de 1000 PBT para simular el pago |
| 1650 | Ocurrió un problema al simular el pago de la orden de venta por medio de wallet externa (deposito con confirmaciones de red), int éntelo nuevamente o consulte con soporte técnico para más ayuda |
| 1651 | El monto para simular el pago por medio de wallet externa (deposito con confirmaciones de red) es muy pequeño, ingrese una cantidad más alta |
| 1652 | Ocurrió un problema al simular el pago de la orden de venta por medio de wallet externa (deposito con confirmaciones de red), inténtelo nuevamente o consulte con soporte técnico para más ayuda |
| 1653 | Ocurrió un problema al simular el pago de la orden de venta por medio de wallet externa (deposito con confirmaciones de red), inténtelo nuevamente o consulte con soporte técnico para más ayuda |
| 1654 | El tipo de depósito debe de ser 1 o 2 |
| 1655 | El Token API no es correcto y la autenticación del usuario ha fallado |
| 1656 | Ocurrió un problema al simular el pago de la orden de venta, inténtelo nuevamente o consulte con soporte técnico para mas ayuda |
| 1657 | Ocurrió un problema al simular el pago de la orden de venta, inténtelo nuevamente o consulte con soporte técnico para más ayuda |
Ejemplo de respuesta EXITOSA
Exitoso
Código HTTP 200
{
"status": true,
"success": {
"code": "0108"
}
}
Descripción de la respuesta
- Revisar el listado de
códigos EXITOSOpara conocer el significado desuccesscode. - Cuando la respuesta al consumo de este servicio es exitosa también se envía la notificación del pago al webhook que el desarrollador tenga dado de alta en el panel de Gestión de API para el ambiente SANDBOX DE PRUEBAS, si no se tiene configurado un webhook, se omite el envió de esta notificación.
Ejemplo de respuesta FALLIDA
Error
Código HTTP 400, Código HTTP 401, Código HTTP 500
{
"status": false,
"error": {
"code": "1639"
}
}
Descripción de la respuesta
- Revisar el listado de
códigos ERRORpara conocer la causa y saber cómo corregir - Si se obtiene un código HTTP
500comunicarse a soporte técnico - Si se obtiene un código HTTP
401revisar que el Token API este correcto
Notas
Si tienes alguna duda recuerda que siempre puedes contactar con el equipo de soporte para desarrolladores ingresando en el siguiente enlace: Soporte para desarrolladores.