Crear empresa
POSThttps://api.pasarela.hi-g.io/admin/merchants
Da de alta una empresa: la registra en el contrato con sus billeteras y condiciones, y devuelve su primera clave de API y su secreto de webhooks. Incluye una transacción en la blockchain, así que tarda unos segundos.
Ver el ejemplo y probar ↓La clave se muestra una sola vez
api_key solo aparece en esta respuesta. El secreto de webhooks sí se puede volver a consultar con Ver secreto de webhooks.
Billetera de administración
Si no envías admin_address, la empresa queda administrada por la cuenta de la plataforma, que entonces sí podría cambiar su tesorería. Para que sea sin custodia de verdad, cada empresa debe tener su propia billetera admin. Ver Sin custodia.
Parámetros del cuerpo
namestringobligatorio
Nombre de la empresa. Entre 1 y 120 caracteres. Se muestra en la página de pago.
treasurystringobligatorio
Dirección que recibe el neto de cada depósito.
fee_walletstring
Dirección que recibe la comisión de la empresa. Si se omite o es null, esa comisión va a la tesorería.
admin_addressstring
Billetera de la empresa que administra su configuración en el contrato. Si se omite o es null, administra la plataforma.
platform_fee_bpsintegerPor defecto: 100
Comisión de la plataforma en puntos básicos (100 = 1 %). Entre 0 y 10000.
merchant_fee_bpsintegerPor defecto: 0
Comisión que la empresa cobra a su usuario, en puntos básicos (200 = 2 %). Entre 0 y 10000.
merchant_fee_baseenumPor defecto: gross
Base de la comisión de la empresa: gross = sobre el depósito; net = sobre lo que queda tras la comisión de la plataforma.
Valores:grossnet
gas_modeenumPor defecto: platform
Quién paga el gas del barrido. Ver Gas.
Valores:platformmerchantcustomer
min_depositnumberPor defecto: 0.5
Depósito mínimo en USD (1 token = 1 USD). Por debajo, el depósito queda como below_minimum y no se acredita. Mínimo 0.
confirmationsintegerPor defecto: 4
Bloques de espera antes de confirmar un depósito. Entre 0 y 10000.
webhook_urlstringPor defecto: null
URL que recibe los webhooks, o null para dejar de enviarlos. En producción debe empezar por https://; en pruebas también se acepta http://.
Cabeceras
x-admin-tokenstringobligatorio
Clave de administración de la plataforma.