Generar un código de compra

POST

/pcode

curl --request POST \
  --url https://partner-pcode-dev.tsp.workers.dev/api/partner/v1/pcode \
  --header 'Content-Type: application/json' \
  --header 'x-gw: <x-gw>' \
  --data '{ "productCode": "FV00", "external_reference_id": "example", "force_new": false }'

• Desarrollo
• Producción

Si se envía external_reference_id y ya existe un código de compra vigente (sin usar, sin bloquear, dentro de su plazo de 14 días) para esa misma referencia, se devuelve ESE mismo código de compra (reused: true) en vez de crear uno nuevo — a menos que se pase force_new: true, que además anula cualquier código de compra anterior con esa referencia.

Authorizations

• PartnerApiKey

Request Body^required

Media typeapplication/json

object

productCode

required

FV00=6 meses, FV01=1 año, FV02=2 años, FV03=3 años.

string

Allowed values: FV00 FV01 FV02 FV03

external_reference_id

Identificador propio del partner, para idempotencia.

string

force_new

boolean

Responses

201

Código de compra creado (o reutilizado — ver data.reused).

Media typeapplication/json

object

success

boolean

data

object

pCode

string

productCode

string

status

string

reused

boolean

createdAt

string format: date-time

Example

{
  "success": true,
  "data": {
    "status": "ACTIVE"
  }
}

400

ProductCode inválido/faltante, o el partner no tiene ese producto habilitado (partner_config.allowed_products — si esa columna es NULL o no existe fila de config, no hay restricción y cualquier productCode válido pasa).

Media typeapplication/json

object

success

boolean

error

string

Example

{
  "success": false
}

401

API Key inválida.

429

Rate limit excedido (60 requests/60s por partner).