Pedido Aprovado/Confirmado pelo Marketplace

Nesta seção explicamos sobre os recursos relacionados a integração do status de aprovação do pedido

Após o pagamento ser concluído e aprovado, o Marketplace deve enviar uma notificação ao Seller avisando que este pode iniciar o processo de faturamento e entrega do pedido.

Caso o Marketplace optar por utilizar o Gateway de Pagamento da Fast Shop e se o pedido for pago parcial ou total no cartão, será alterado o status para "Processando", já para as outras formas de pagamento será alterado o status para "Pago".

No corpo da solicitação contém apenas uma informação: o “marketplaceOrderId”, que identifica o pedido no Marketplace. O Seller irá usar esse ID para acionar o processo decorrente do pedido correspondente.

O Seller irá responder com o mesmo “marketplaceOrderId” e também com o “orderId”, que identifica o pedido no Seller, data e hora do recebimento da notificação e um código de protocolo que confirma seu recebimento.

Endpoint

Ready For Handling

POST https://{environmentSeller}/pvt/orders/{orderId}/fulfill

Path Parameters

Name	Type	Description
{environmentSeller}*	string	URL da API do Seller
{orderId}*	string	ID do Pedido do Seller

Headers

Name	Type	Description
X-VTEX-API-AppKey*	string	{{appKey}}
X-VTEX-API-AppToken*	string	{{appToken}}
Accept*	string	application/json
Content-Type*	string	application/json

200: OK Se a notificação for realizada com sucesso

Consulte o Swagger API

400: Bad Request Se a requisição não atender os requisitos mínimos

401: Unauthorized Se a requisição não for autenticada

429: Too Many Requests Muitos requests simultâneos

500: Internal Server Error Se ocorrer um erro no servidor

403: Forbidden As credenciais não estão ativas para acessar o serviço

Exemplo do Request

{
    "marketplaceOrderId": "000004951"
}

Exemplo do Response (200 - OK)

{
    "date": "2023-05-24T23:27:31.2196829Z",
    "marketPlaceOrderId": "000004951",
    "orderId": "HQ0000304",
    "receipt": "e5f3d471-bc0d-44d1-8042-5422198666a6"
}

Descrições dos campos consulte o "Swagger API"

Caso o pedido tenha sido confirmado anteriormente ou avançou o fluxo, não será aceita a notificação

A API permite até 5 requisições por segundo, caso ultrapasse esse limite será retornado status 429: Too Many Request

Caso ocorra um erro ao enviar o dado é importante que persista em um segundo momento para garantir a entrega. Caso persista o erro entre em contato conosco