Crear y emitir secreto una sola vez

POST

/api/v2/webhooks

curl --request POST \
  --url https://monedapi.ar/api/v2/webhooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "url": "example", "currency": "USD", "origin": "BNA", "enabled": true, "receiverAuthorization": "example", "operationId": "example" }'

Cuenta propia, independiente de la key creadora. 30 pedidos/min y 20.000 privados/día UTC compartidos. Sin credenciales en query; gestión con reserva adicional. Cuatro intentos, diez segundos por intento, siete días por creación.

Authorizations

• BearerAuth
• ApiKeyAuth

Request Body^required

Media typeapplication/json

object

url

required

URL HTTPS pública, sin userinfo/fragmento, sin redirects; validación DNS y pinning en cada conexión.

string

<= 2048 characters

currency

required

string

Allowed values: USD ARG EUR BRL CLP UYU

origin

required

string

Allowed values: BNA BLUE OFICIAL CCL TARJETA CRIPTO MAYORISTA BOLSA FUTURO RIESGO CER UVA

enabled

required

boolean

default: true

receiverAuthorization

Any of:

string

string

>= 1 characters <= 2048 characters

null

null

operationId

required

UUID de la operación. Reconciliar no duplica ni vuelve a mostrar el secreto.

string

/^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/

Responses

200

Operación reconciliada; no vuelve a emitir el secreto.

Media typeapplication/json

object

webhook

required

object

id

required

string

/^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/

operationId

required

string

/^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/

currency

required

string

Allowed values: USD ARG EUR BRL CLP UYU

origin

required

string

Allowed values: BNA BLUE OFICIAL CCL TARJETA CRIPTO MAYORISTA BOLSA FUTURO RIESGO CER UVA

destination

required

string

enabled

required

boolean

receiverAuthorizationConfigured

required

boolean

state

required

string

Allowed values: active manual failure capacity inherited

source

required

string

Allowed values: v1 v2

version

required

integer

> 0 <= 9007199254740991

needsSync

required

boolean

createdAt

required

string format: date-time

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$/

secret

Solo creación/rotación exitosa. Guardarlo: no se recupera en GET ni al reconciliar.

string

/^[a-f0-9]{64}$/

reconciled

required

boolean

Example

{
  "webhook": {
    "currency": "USD",
    "origin": "BNA",
    "state": "active",
    "source": "v1"
  }
}

Headers

Cache-Control

string

Allowed value: no-store

201

Crear y emitir secreto una sola vez

Media typeapplication/json

object

webhook

required

object

id

required

string

/^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/

operationId

required

string

/^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/

currency

required

string

Allowed values: USD ARG EUR BRL CLP UYU

origin

required

string

Allowed values: BNA BLUE OFICIAL CCL TARJETA CRIPTO MAYORISTA BOLSA FUTURO RIESGO CER UVA

destination

required

string

enabled

required

boolean

receiverAuthorizationConfigured

required

boolean

state

required

string

Allowed values: active manual failure capacity inherited

source

required

string

Allowed values: v1 v2

version

required

integer

> 0 <= 9007199254740991

needsSync

required

boolean

createdAt

required

string format: date-time

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$/

secret

Solo creación/rotación exitosa. Guardarlo: no se recupera en GET ni al reconciliar.

string

/^[a-f0-9]{64}$/

reconciled

required

boolean

Example

{
  "webhook": {
    "currency": "USD",
    "origin": "BNA",
    "state": "active",
    "source": "v1"
  }
}

Headers

Cache-Control

string

Allowed value: no-store

400

Cuerpo/query inválidos, campos desconocidos o name.

Media typeapplication/json

Error con la forma de v1, como {"error":"Cotización no encontrada"}.

object

error

required

string

Example^generated

{
  "error": "example"
}

401

API key ausente/inválida. Una cookie no la sustituye.

Media typeapplication/json

Error con la forma de v1, como {"error":"Cotización no encontrada"}.

object

error

required

string

Example^generated

{
  "error": "example"
}

404

Recurso ajeno, inexistente o ya vencido; indistinguibles.

Media typeapplication/json

Error con la forma de v1, como {"error":"Cotización no encontrada"}.

object

error

required

string

Example^generated

{
  "error": "example"
}

409

Tope de cinco, versión cambiada, envío en curso o quote_unavailable.

Media typeapplication/json

Error con la forma de v1, como {"error":"Cotización no encontrada"}.

object

error

required

string

Example^generated

{
  "error": "example"
}

429

30/min por key compartidos con auth/check.

Media typeapplication/json

Error con la forma de v1, como {"error":"Cotización no encontrada"}.

object

error

required

string

Example^generated

{
  "error": "example"
}

Headers

Retry-After

integer

503

Capacidad de gestión/entregas o presupuesto diario privado agotado.

Media typeapplication/json

Error con la forma de v1, como {"error":"Cotización no encontrada"}.

object

error

required

string

Example^generated

{
  "error": "example"
}

Headers

Retry-After

integer