Subir el logo de tu marca

PUT/giftcards/programa/logoProbar

URL base

API key x-api-keyRecordar la clave en este navegador (localStorage, no sale de aquí)Cuerpo de la petición (JSON){}

Enviar peticiónCopiar como curl

La llamada la hace tu navegador, contra el servidor que elijas arriba. Si la documentación no está servida desde el mismo origen que la API, el navegador puede bloquear la respuesta por CORS: en ese caso abre estas páginas desde la propia API (/docs) o usa el curl de arriba.

PUT

/giftcards/programa/logo

curl --request PUT \
  --url http://localhost:3000/v1/giftcards/programa/logo \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{ "logo": "data:image/png;base64,iVBORw0KGgo…" }'

• Pruebas (sandbox)
• Producción

Scope giftcards:write. PNG o JPEG como data: URL, hasta 180 kB. null lo quita.

Authorizations

• ApiKeyAuth

Request Body^required

Media typeapplication/json

object

logo

required

string

nullable <= 260000 characters

Example

data:image/png;base64,iVBORw0KGgo…

Responses

200

El programa, con tieneLogo

Media typeapplication/json

object

estado

string

Allowed values: activo suspendido

kit

object

nombre

required

string

<= 60 characters

colores

object

primario

string

/^#[0-9A-Fa-f]{6}$/

acento

string

/^#[0-9A-Fa-f]{6}$/

fondo

string

/^#[0-9A-Fa-f]{6}$/

superficie

string

/^#[0-9A-Fa-f]{6}$/

texto

string

/^#[0-9A-Fa-f]{6}$/

texto_secundario

string

/^#[0-9A-Fa-f]{6}$/

radio

integer

<= 32

textos

Hasta 60 caracteres. {marca} se cambia por el nombre de la tienda.

object

titulo

string

<= 60 characters

boton_pagar

string

<= 60 characters

boton_secundario

string

<= 60 characters

regalo_para

string

<= 60 characters

soporte

object

whatsapp

Código de país y sólo dígitos

string

/^\d{8,15}$/

email

string format: email

url

Https://

string

pie_legal

string

<= 240 characters

tieneLogo

boolean

marcas

Las que elegiste; null = todas las habilitadas

Array<string>

nullable

marcasPermitidas

Las que te habilitamos; null = todas

Array<string>

nullable

marcasEfectivas

Las que puedes emitir hoy

Array<string>

nullable

version

Sube con cada cambio

integer

Example

{
  "estado": "activo",
  "kit": {
    "nombre": "Cacao Pay"
  }
}

400

Error con código estable

Media typeapplication/json

object

error

object

meta

Contexto estructurado del error cuando lo hay: qué límite se superó y de cuánto, qué campo es inválido, cuánto saldo había. No aparece en errores internos.

object

key

additional properties

any

type

string

Allowed values: invalid_request_error authentication_error rate_limit_error upstream_error api_error

code

Código ESTABLE. Programa contra esto.

string

message

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error",
    "code": "insufficient_balance",
    "request_id": "req_8a0312ba896772bc441134cd"
  }
}