Introducción
El equipo de AceptaBits te da la bienvenida y te presenta su API web para poder implementar los servicios de la pasarela de pagos AceptaBits en tu proyecto.
Esta documentación está pensada para que paso a paso puedas implementar de una forma sencilla los servicios que AceptaBits ofrece en su plataforma, como por ejemplo:
- Creación de órdenes de venta
- Crear y gestionar tus tiendas
- Crear y gestionar tus productos y servicios
- y mucho más....
Lo esencial para comenzar
El primer paso para comenzar a utilizar los servicios por medio de API es ingresar en la sección de Gestión de API, disponible dentro de tu cuenta de AceptaBits, para ir a esta sección dirígete al pie de página (footer) y selecciona la opción Gestión de API que se encuentra en sección de Desarrolladores
O ingresan desde el siguiente enlace dando clic aquí: Gestión de API.
Es necesario haber iniciado Sesión dentro de la plataforma para poder ingresar en esta sección, de lo contrario no podrás ingresar
Elementos importantes dentro de Gestión de API
Dentro de esta sección podrás gestionar lo que necesitas para el uso del API web de AceptaBits, dicho esto, es importante que conozcas un poco sobre que es cada cosa, a continuación, te daremos una breve introducción a cada una de las partes que componen esta sección:
Token API
El primer elemento esencial para utilizar el API web de AceptaBits es el Token API, este token tiene la función de autenticar tu cuenta al momento de consumir los servicios, cada cuenta en AceptaBits tiene la posibilidad de generar un token para el ambiente PRODUCCION y un token para el ambiente SANDBOX DE PRUEBAS, sin este token no es posible realizar peticiones satisfactoriamente a los servicios de la plataforma.
Ambiente PRODUCCION
El ambiente de PRODUCCION se refiere a todo el entorno final donde las peticiones se realizarán y afectaran directamente a tu cuenta de AceptaBits, ya sea que generes órdenes de venta, desde de alta tiendas, agentes, productos & servicios, etc...
Por este motivo recomendamos APLIAMENTE que NO realices pruebas que puedan afectar a tu cuenta dentro de este ambiente
Ambiente SANDBOX DE PRUEBAS
El ambiente SANDBOX DE PRUEBAS se refiere a un ambiente donde podrás realizar tus pruebas de implementación libremente sin la preocupación de que algo pueda afectar a tu cuenta de AceptaBits en el entorno productivo, este ambiente cuenta con las mismas características que el ambiente productivo por lo que podrás realizar tus pruebas de implementación sin preocuparte por que "algo sea diferente" dentro del entorno productivo.
WEBHOOK para notificaciones
Dentro de la sección de Gestión de API podrás dar de alta, cambiar o eliminar el webhook de notificaciones tanto para el ambiente PRODUCCION como para el ambiente SANDBOX DE PRUEBAS.
La función principal de este webhook es que los desarrolladores puedan recibir una notificación cada vez que una orden reciba un pago, ya sea que la orden se haya pagado de manera completa o parcialmente, este sistema es muy útil para las implementaciones de este tipo y ayuda mucho para tener una implementación más completa.
Historial de llamadas
Dentro de esta sección encontraras una herramientas bastante útil, la cual es el Historial de llamadas, la función principal de esto es que los desarrolladores tenga acceso al histórico de peticiones que han realizado a la API web de AceptaBits, ver qué respuesta entrego las peticiones, el endpoint utilizado, etc., además, podrás ver el histórico de llamadas que AceptaBits ha realizado a tus webhooks, en general será una herramientas bastante útil a la hora de implementar los servicios de AceptaBits en tu proyecto
Elementos importantes dentro de la plataforma
Además de lo que conlleva la gestión completa en cuanto a la API web se refiere, también es importante conocer todos los elementos que componen la plataforma de AceptaBits, como lo son las tiendas o las órdenes de venta por mencionar un par de ejemplos, esto es de vital importancia ya que toda la estructura y funcionalidad de la API web de AceptaBits se centra en el manejo estos elementos.
Por ejemplo, para crear una orden de venta es necesario saber con cual moneda se pagará dicha orden, tener un cliente y por lo menos un producto o un servicio, pero ¿sabías que para crear un cliente antes debes de tener una tienda? o para crear un producto y/o un servicio también debes de tener antes una tienda?
Por eso mismo es importante saber qué es y para qué sirve cada uno de los elementos que conforman la plataforma, a continuación, explicaremos y detallaremos más a fondo cada uno de ellos.
Definición y explicación de una MONEDA
Las monedas en la plataforma de AceptaBits son las comúnmente conocidas criptomonedas, como puede ser el ejemplo de Bitcoin (BTC) o PesoBits (PBT), estas monedas son las utilizadas en la pasarela de pago para realizar el pago de órdenes de venta, como ya imaginaras, en esta pasarela de pagos no se manejan las monedas fiat como por ejemplo el MXN (Peso mexicano), utiliza exclusivamente criptomonedas para su operación.
Estas criptomonedas son de vital importancia ya que representan uno de los 3 elementos principales con los que se compone una orden de venta, en AceptaBits contamos con un listado de las criptomonedas soportadas en la plataforma, este listado puede ser consultado de manera muy sencilla por medio de uno de los servicios que se pueden consumir en la API web, si requieres más información acerca del funcionamiento de cada criptomoneda te sugerimos ingresar en sus páginas oficial, o realizar una investigar externa acerca de cómo funcionan y operan los blockchains, para uso practico dentro de AceptaBits solo nos referiremos a ellas por su nombre o código de moneda.
Definición y explicación de una TIENDA
Las tiendas son la columna vertebral dentro de la plataforma de AceptaBits, todo lo que representa operación está ligado a una tienda, así mismo cada uno de los elementos importantes de la plataforma debe forzosamente estar ligado a una, los elementos ligados a una tienda son los siguientes:
- sucursales
- productos
- servicios
- agentes de venta
- clientes
- órdenes
Entraremos en detalle más delante sobre cada uno de estos elementos, pero para información general, ninguno de ellos puede existir si no se tiene previamente creada una tienda.
Las tiendas son una representación virtual de tu negocio, empresa o a ti mismo como un prestador de servicios, dentro de AceptaBits las tiendas tiene su propio nombre, código de identificación, incluso puedes agregar dirección, email, teléfono de contacto o el logotipo de tu marca, todos estos elementos son importantes por varios motivos:
- El primer motivo es para poder identificar a tu negocio, tienda, empresa o identificarte a ti mismo como prestador de servicios.
- Otro motivo es que los potenciales clientes que entran en la plataforma buscando donde pueden pagar por algún servicio o adquirir bienes puedan encontrar tu tienda.
- Como se mencionó anteriormente, las tiendas son la columna vertebral ya que todos los demás elementos están ligados a las tiendas, cuando das de alta una orden de venta necesitas ingresar un cliente, cliente que debe de pertenecer a una de tus tiendas, también debes de agregar un producto o un servicio, los cuales deben ya de estar creados en el catálogo de productos o de servicios de tus tiendas, si quieres tener un mayor número de resultados en la búsqueda de tus futuros clientes puedes dar de alta las sucursales de tu negocio, y por supuesto, deben de estar ligadas a tus tiendas, esto entre otros ejemplos.
- Las tiendas representan en sí mismas un filtro importante para tener tu reportería mejor organizada, imagina que tienes 10 negocios diferentes y todo lo tienes dado de alta en una sola tienda, seria complicado realizar un filtrado adecuado, aquí entra otra de las funciones de las tiendas.
- Las tiendas también son importantes para tener un control adecuado de tus agentes de ventas, identificar a que tienda pertenecen y por ende saber qué y cuanto han vendido.
- La ubicación de tu tienda es un elemento que recomendamos ampliamente ingresar, ya que podrá mostrarse en los resultados de búsqueda dentro del mapa que aparece en el buscador de AceptaBits, claro que puede omitirse pero da más presencia a la misma y por consecuencia a ti mismo o tu negocio.
- Al ingresar por primera vez en la plataforma, ya sea desde la web o la app de MercadoBits, se generara en automático una tienda llamada Tienda general.
La lógica de una tienda consta de lo siguiente:
- Es forzosamente necesario darle un nombre a tu tienda.
- opcionalmente podrás ingresar los demás apartados como lo son dirección, ubicación, teléfono o email de contacto.
- Una vez creada tu tienda ya puedes comenzar a ligarle los diferentes elementos como lo son productos o servicios.
- Las tiendas se pueden editar o eliminar en cualquier momento, excepto las tiendas generadas por default (para más información consulta los métodos de edición y eliminación de las tiendas).
Como podemos observar, las tiendas son el pilar dentro de la plataforma de AceptaBits, se pueden tener tantas tiendas como el usuario lo requiera, no existe un límite lo cual beneficia a organizaciones, negocios o personas tanto grandes o pequeñas en cuanto a volumen de operación se refiere.
Cada tienda generada en AceptaBits tiene su propio código de identificación, este código es muy importante para el uso de la API web y se genera de manera automática, no se puede cambiar o ingresarlo manualmente, un ejemplo de cómo luce un código de tienda es el siguiente: pgbsho40996222369461182
Definición y explicación de una SUCURSAL
Las sucursales son una extensión de una Tienda, estos elementos brindan principalmente mayor visibilidad a tu negocio, empresa o a ti mismo como prestador de servicios en los resultados de búsqueda de los potenciales clientes que entren a la plataforma, la lógica de una sucursal consta de lo siguiente:
- Es necesario tener una tienda previamente creada para que se le asigne la sucursal.
- Es necesario que ingreses al menos la dirección física de tu sucursal, opcionalmente puedes agregar un teléfono o email de contacto, así mismo, una ubicación en coordenadas para poder mostrarla en el mapa.
- la sucursales se pueden editar o eliminar en cualquier momento (para más información consulta los métodos de edición y eliminación de las sucursales).
Como ya mencionamos la principal función de una sucursal es dar mayor visibilidad a tu negocio en los resultados de búsqueda, no se pueden ligar productos, servicios u órdenes de venta, si lo que necesitas es que una sucursal tenga su propio catálogo, genere sus propias órdenes de venta o tenga sus propios agentes de venta, necesitaras dar de alta una nueva tienda en lugar de una sucursal, tendrá la misma visibilidad que la sucursal en el buscador pero con todo lo que implica una tienda.
Cada sucursal generada en AceptaBits tiene su propio código de identificación, este código es muy importante para el uso de la API web y se genera de manera automática, no se puede cambiar o ingresarlo manualmente, un ejemplo de cómo luce un código de sucursal es el siguiente: pgbshobra2691913978258427
Definición y explicación de un PRODUCTO
Los productos de una Tienda son básicamente el catálogo de lo que ofrece tu tienda en cuanto a productos se refiere (por ejemplo: papel, computadoras, alimentos, etc...), dentro de la plataforma un producto siempre tiene un precio fijo, a diferencia de los servicios que pueden o no tener un precio fijo.
Los productos también representan uno de los 3 elementos principales con los que se compone una orden de venta, ya que estas necesitan de al menos un producto o servicio para poder generarse, la lógica para estos elementos es la siguiente:
- Es necesario tener una tienda previamente creada para que se le asigne el producto.
- Los productos deberán de tener forzosamente un nombre.
- El precio de un producto se ingresa en MXN (Peso mexicano) y no puede estar vacío o tener un precio de $0.00 MXN, siempre deberá de contener un precio.
- Al ingresar un producto en el carrito de compras de una orden de venta se utilizara su precio junto con la cantidad para calcular el equivalente en la criptomoneda con la que se va a pagar (esto aplica para órdenes cuyo total se calcule de manera automática, para más información de este aspecto ingresa en la documentación del método add-order).
- Los productos se pueden editar o eliminar en cualquier momento (para más información consulta los métodos de edición y eliminación de los productos).
Cada producto generado en AceptaBits tiene su propio código de identificacion, este código es muy importante para el uso de la API web y se genera de manera automática, no se puede cambiar o ingresarlo manualmente, un ejemplo de cómo luce un código de producto es el siguiente: pgbpro3373249555686112
Definición y explicación de un SERVICIO
Los servicios de una Tienda son básicamente el catálogo de lo que ofrece tu tienda en cuanto a servicios se refiere (por ejemplo: reparación de equipo de cómputo, mano de obra para algún trabajo, asesorías, servicios de enseñanza, etc..), dentro de la plataforma un servicio puede o no tener un precio fijo, a diferencia de los productos que siempre tienen un precio fijo.
Los servicios también representan uno de los 3 elementos principales con los que se compone una orden de venta, ya que estas necesitan de al menos un producto o servicio para poder generarse, la lógica para estos elementos es la siguiente:
- Es necesario tener una tienda previamente creada para que se le asigne el servicio.
- Los servicios deberán de tener forzosamente un nombre.
- El precio de un servicio es opcional y se ingresa en MXN (Peso mexicano), a diferencia los productos, estos si pueden tener un precio de $0.00.
- Al ingresar un servicio en el carrito de compras de una orden de venta se utilizara su precio junto con la cantidad para calcular el equivalente en la criptomoneda con la que se va a pagar (esto aplica para órdenes cuyo total se calcule de manera automática, sin embargo existe la limitante de que si el servicio no tiene un precio fijo, se deberá de ingresar el total de la orden de manera manual, para más información de este aspecto ingresa en la documentación del método add-order).
- Los servicios se pueden editar o eliminar en cualquier momento (para más información consulta los métodos de edición y eliminación de los servicios).
- Siempre se generará un servicio llamado Venta general al momento de dar de alta una tienda.
Cada servicio generado en AceptaBits tiene su propio condigo de identificación, este condigo es muy importante para el uso de la API web y se genera de manera automática, no se puede cambiar o ingresarlo manualmente, un ejemplo de cómo luce un condigo de servicio es el siguiente: pgbser67889721988875944
Definición y explicación de un AGENTE
Los agentes o agentes de venta son básicamente una extensión de tu cuenta de usuario en AceptaBits, es decir los agentes operan con tu cuenta maestra, pero tienen sus propias credenciales de inicio de sesión, esto es muy útil cuando tienes empleados que necesitan vender con AceptaBits, pero sin la necesidad de que ellos conozcan tu email, teléfono o contraseña (tus credenciales con las que ingresas a tu cuenta de MercadoBits o AceptaBits).
Tener agentes de venta implica ampliar tu operación sin comprometer tu cuenta principal, se pueden dar de alta tantos agentes como se requiera pero hay que tener en cuenta la lógica de operación que detallaremos a continuación:
- Es necesario tener una tienda previamente creada para que se le asigne el agente.
- Los agentes de venta deben de tener su nombre completo (esto ayuda a que tu como dueño de la cuenta puedas identificarlos)
- Los agentes necesitan un numero de teléfono y un email que sean funcionales, utilizaran estos elementos para poder iniciar sesión y dar de alta su propio pin de seguridad para confirmar sus acciones.
- Los agentes necesitan de una contraseña de al menos 8 caracteres, con esta contraseña iniciaran sesión
- EL email y número de teléfono no puede estar repetido, es decir, cada agente dado de alta debe de tener su propio email y numero de teléfono, esto es debido a que el inicio de sesión de un agente y su estructura es muy similar al de un usuario normal de AceptaBits y MercadoBits.
- Los agentes no puede cambiar o editar su propia información (nombre, email, teléfono, contraseña, etc...), la gestión de los agentes es exclusiva del usuario principal de la cuenta.
- Los agentes de venta únicamente pueden dar de alta clientes y órdenes de venta, no pueden agregar, editar o eliminar tiendas, sucursales, productos y servicios, lo único que pueden editar es la información de los clientes que ellos mismos den de alta (si el agente solicita algo de lo anterior deberá de consultar con el dueño de la cuenta principal ya que solo él o ella tiene la facultad de hacer este tipo de acciones).
- En reportería se pueden filtrar las órdenes de venta que ha generado cada uno de tus agentes.
- Se puede activar o desactivar la cuenta de un agente, es decir, darle el permiso de que pueda o no pueda ingresar a la plataforma, este aspecto es útil si das de baja por ejemplo a uno de tus empleados vendedores pero no quieres eliminar completamente al agente de tu lista, si eliminas un agente de tu lista de agentes no podrá ingresar nuevamente a la plataforma y el email y número de teléfono quedaran nuevamente libres para ser utilizados por otro agente que des de alta.
En resumen, los agentes de venta son una herramientas muy útil en la operación de negocios que ya cuentan con varios empleados y requieren que puedan vender con AceptaBits sin la necesidad de comprometer la cuenta principal.
Cada agente generado en AceptaBits tiene su propio condigo de identificación, este condigo es muy importante para el uso de la API web y se genera de manera automática, no se puede cambiar o ingresarlo manualmente, un ejemplo de cómo luce un condigo de agente es el siguiente: pgbage9743164921458226
Definición y explicación de un CLIENTE
Los clientes son uno de los 3 elementos principales con los que se compone una orden de venta, son como su nombre lo indica el cliente al que se le venderá el producto o servicio que se agregue en el carrito de compras de la orden, aunque no necesariamente debemos tener un cliente por cada persona o para empresa o negocio al que se le venden servicios o bienes, pero si ayudaran bastante al momento de identificar qué y a quien se le vendió algo, la lógica de los clientes la podemos definir de la siguiente manera:
- Es necesario tener una tienda previamente creada para que se le asigne el cliente.
- Los clientes deben de tener fogosamente un nombre, ya sea de una persona o de una empresa o negocio.
- Los clientes opcionalmente pueden tener apellidos, email y teléfono de contacto.
- El email y teléfono no es único, es decir, se puede repetir, ya que los clientes no son usuarios de la plataforma, sino solamente un identificador de una persona, empresa o negocio al que se le vende un producto o servicio.
- Los clientes pueden o no tener un agente de ventas asignado, si el cliente tiene un agente de ventas asignado se deberá de especificar en la orden de venta si se desea asignar también a su respectivo agente (para más información consulte la documentación del método add-order).
- Los clientes también funcionan como filtro en la reportería para poder identificar las órdenes de venta que se han asignado a cada cliente y por ende también a cada agente.
- Los clientes son exclusivos de cada tienda, no se pueden compartir entre tiendas, por lo que, si el mismo cliente se usa en dos o más tiendas, se deberá de dar de alta un cliente con los mismos datos en cada una de las tiendas donde se utilice.
- Los agentes de venta pueden dar de alta sus propios clientes y estar asignados a dicho agente.
- Los clientes se pueden editar y borrar en cualquier momento, los agentes solo pueden editar sus propios clientes mas no eliminarlos.
- Se generará un cliente por default llamado Cliente general cada vez que se genere una tienda nueva, así mismo, se generara un cliente llamado Cliente agente General agente cada vez que se dé de alta un agente de ventas.
En resumen los clientes son uno de los elementos principales de la plataforma al ser uno de los 3 elementos principales de una orden de venta, sin embargo, se puede tener toda la operación de una tienda y utilizar al mismo cliente siempre, como por ejemplo, el cliente que se llama Cliente general (que es uno de los elementos que se generan por default al momento de dar de alta una tienda o un agente de ventas), aunque si es recomendable tener el respectivo listado de clientes para tener un mejor conocimiento de que y a quien se le ha vendido algo, aunque como ya mencionamos no es estrictamente necesario.
Cada clientes generado en AceptaBits tiene su propio código de identificación, este código es muy importante para el uso de la API web y se genera de manera automática, no se puede cambiar o ingresarlo manualmente, un ejemplo de cómo luce un código de un cliente es el siguiente: pgbcus37375715916693313
Definición y explicación de una ORDEN DE VENTA
Las órdenes de venta son el eje central de las operaciones en AceptaBits, sus 3 elementos principales son:
- El cliente
- La moneda con que se pagara la orden
- El carrito de compras (al menos un producto o un servicio)
Las órdenes de venta serán el medio con el cual los clientes finales podrán pagar por sus productos y/o servicios, su principal característica es la dirección de deposito, esta dirección es única para cada orden generada en AceptaBits y tiene su origen dentro del blockchain de la criptomoneda con la que se va a pagar la orden.
Las órdenes tiene diferentes estados dependiendo de si ya están abiertas al cliente, si están recién creadas, si ya recibieron algún pago, si el pago fue por medio de usuarios de MercadoBits o por una wallet externa, si ya expiraron, entre otros ejemplos, los desarrolladores encontraran todos estos estados y su explicación al ingresar en la documentación de los métodos para órdenes: add-order, show-order, show-order-customer, get-orders y calculate-order, recomendamos ampliamente tomarse el tiempo necesario para leer a conciencia toda la documentación, no solo de estos métodos sino de todos los servicios que componen la API web.
Como ya mencionamos la orden tiene 3 elementos principales, entremos un poco más a detalle en cada uno de ellos:
-
El cliente: este elemento representa el cliente final al cual se le venderán los productos y/o servicios, para poder ingresar un cliente en la orden de venta debemos tenerlo previamente generado, a su vez para generar un cliente debemos tener previamente genera la tienda a la cual se asignara dicho cliente, cuando un cliente es ingresado en la orden de venta estamos ingresando de manera indirecta la tienda a la que pertenecerá la orden de venta, esto es debido a la relación que existe entre Tienda - Cliente, así mismo como se mencionó en el apartado de CLIENTES, se puede tener toda la operación de una tienda utilizando únicamente un solo cliente, pero para beneficio del dueño de la cuenta de AceptaBits, se le da la oportunidad de tener un listado completo de clientes para tener un mejor control de qué y a quien se le vende un producto o un servicios.
-
La moneda con que se pagara la orden: este elemento representa la moneda con la que el cliente final pagara por sus productos y/o servicios, como se sabe, la pasarela de pagos de AceptaBits utiliza únicamente criptomonedas para esta labor, así mismo, dependiendo de que moneda se elija para una orden se verán reflejadas las ventajas, limitaciones y características que tenga cada blockchain, por ejemplo, las direcciones de depósito para Bitcoin (BTC) no son iguales a las direcciones de depósito de PesoBits (PBT), su función es la misma pero la forma de escribirse son distintas, también, las confirmaciones de red que requiere cada moneda y el tiempo que demora cada una de ellas no es igual entre un blockchain y otro, por otra parte, es importante mencionar que cuando una orden de venta es pagada directamente por un usuario de MercadoBits, estas ventajas, limitaciones y características prácticamente no importaran, esto es debido a que los pagos provenientes de usuarios de MercadoBits se reflejan de manera instantánea a la orden de venta (no hay que esperar confirmaciones de red como es el caso de depósitos que provienen de otro exchange u otra wallet externa).
-
El carrito de compras (al menos un producto o un servicio): Este elemento representa los productos y/o servicios que se le venderán al cliente final, una orden de venta siempre debe de tener al menos un producto o un servicio y nunca podrá ir vacío el carrito de compras, para poder ingresar productos y servicios al carrito se deben de tener creados previamente, y para poder crearlos se necesita tener previamente una tienda (como se vio en la sección de PRODUCTOS y SERVICIOS de esta introducción), un punto indispensable a mencionar es que los productos y servicios pertenezcan a la misma tienda a la que pertenece el cliente que se utilizara en la orden (he ahí el por qué las tiendas son la columna vertebral de toda la operación), si se ingresan productos o servicios de otra tienda no se verán reflejados en el carrito de compras y por ende quedar vacío dicho carrito, si esto ocurre no se podrá generar la orden de venta, otro punto importante a mencionar es que el carrito de compras además de ser una representación de que es lo que se está vendiendo, también tiene la función de calcular el total a pagar de la orden de venta utilizando le precio de los productos y/o servicios agregados (claro está que se realiza la conversión del precio de los productos y servicios a la criptomoneda con la que se pagara, demás esto pasa únicamente si se da de alta una orden con este tipo de configuración, ya que también existe la opción de agregar el total de la orden de venta de manera manual, pero todo esto se profundizara a detalle en la respectiva documentación del método add-order).
Para finalizar, podemos decir que la forma en la que un cliente final pude pagar una orden es bastante amplia, se puede compartir la orden de venta por medio de su enlace de pago (una url que se puede abrir en un navegador o también se puede abrir directamente en la app de MercadoBits), se pude compartir el código de orden para que usuarios de MercadoBits la puedan buscar directamente en su app, se puede compartir la dirección de deposito y el monto a pagar para usuario que pagan desde una wallet externa, entre otros ejemplos, los desarrolladores deberán de hacer uso del método show-order-customer para poder obtener y mostrar la información de pago a un cliente, aunque siempre pueden apoyarse de los métodos antes mencionados que se pueden encontrar dentro de la sección de ÓRDENES dentro de la plataforma de AceptaBits, lo importante es que el cliente final tenga la dirección de depósito y el monto que debe de pagar, mientras el cliente deposite la cantidad solicitada a la dirección de la orden no habrá ningún problema.
Cada orden de venta generada en AceptaBits tiene su propio código de identificación, este código es muy importante para el uso de la API web y se genera de manera automática, no se puede cambiar o ingresarlo manualmente, un ejemplo de como luce un código de una orden de venta es el siguiente: pgbord124539965825815834
Cada orden de venta generada en AceptaBits tiene su propio slug de identificación, este slug es muy importante para el uso de la API web o para abrir órdenes de venta a los clientes en un navegador web, se genera de manera automática, no se puede cambiar o ingresarlo manualmente, un ejemplo de cómo luce un slug de una orden de venta es el siguiente: 0f4adbccfaa219d54462fb224aff52abc2539230ikWaIWVdF9tDXUju0fC0
Cada orden de venta generada en AceptaBits y que este abierta para el cliente tiene su propia dirección de depósito, esta dirección es muy importante para el uso de la API web y para que el cliente pueda pagar, se genera de manera automática, no se puede cambiar o ingresarla manualmente, un ejemplo de cómo luce una dirección de depósito de una orden de venta es el siguiente: pbtcrt1qm9xzxzrdhu7hvk202dxvdwgc0tjug8ras3pws2 (cada moneda soportada en la plataforma genera sus propias direcciones de depósito y siempre serán únicas para cada orden de venta)
Dentro de esta documentación encontraras todo lo que necesitas para comenzar a consumir los servicios de AceptaBits, como por ejemplo:
- Como generar el Token API
- Los endpoints que utilizaras para cada ambiente
- Como dar de alta el webhook de notificación
- Todos los métodos disponibles que puedes consumir
- Ejemplos de cómo realizar las peticiones
- y mucho mas
Para conocer más acerca de los elementos creados por default que se han mencionado a lo largo de esta introducción no dudes en consultar la sección: Elementos creados por default.
Si tienes alguna duda recuerda que siempre puedes contactar con el equipo de soporte para desarrolladores ingresando en el siguiente enlace: Soporte para desarrolladores.