Xsolla-logoXsolla Developers
ou
Conta de Distribuidor

Criar código de cupomServer-sideAdmin

post/v2/project/{project_id}/admin/coupon/{external_id}/code

Cria código de cupom.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

Example: 44056
external_id
required
integer

ID externo de promoção. Identificador exclusivo da promoção dentro do projeto.

Example: coupon_44056_1
Request Body schema: application/json
coupon_code
string [ 1 .. 128 ] characters ^[a-zA-Z0-9]+$
Default: "WINTER2021"

Código exclusivo que diferencia maiúsculas de minúsculas. Contém letras e números.

Responses
201

Código criado com sucesso.

401

Autenticação básica não aprovada ou errada. Verifique se você usou a autenticação básica ou as credenciais corretas.

404

Cupom não encontrado. Verifique se o external_id está correto.

422

Solicitação inválida. O código já existe.

Request samples
application/json
{
  • "coupon_code": "WINTER2021"
}
Response samples
application/json
{
  • "errorCode": 4001,
  • "errorMessage": "[0401-9802]: Coupon not found",
  • "statusCode": 404,
  • "transactionId": "x-x-x-x-transactionId-mock-x-x-x"
}