La transferencia de créditos es el flujo que permite al marketplace transferir créditos de publicidad a sus sellers. Esta documentación detalla los endpoints que el marketplace debe implementar y el webhook que debe consumir para realizar la integración con VTEXAds.
GET /checking_account)
seller_id, publisher_id (opcional, utilizado solo en casos donde una entidad gestiona múltiples publishers).{ "total": "1111.00" }
POST /checking_account/transfer)
{
"amount": "10.00",
"seller_id": "SELLER_ID",
"publisher_id": "PUBLISHER_ID",
"transfer_identity_id": "uuid"
}
201 Created
{
"transaction_id": "TRANSACTION_ID",
"status": "success"
}
400 Bad Request
{
"transaction_id": "TRANSACTION_ID",
"status": "failure",
"message": "Motivo del rechazo"
}
202 Accepted
{
"transaction_id": "TRANSACTION_ID",
"status": "processing"
}
POST https://api-retail-media.newtail.com.br/webhook/marketplace/transfers/:publisher_idx-api-key y x-secret-key.{
"transaction_id": "TRANSACTION_ID",
"status": "success"
}
o
{
"transaction_id": "TRANSACTION_ID",
"status": "failure",
"message": "Descripción del problema"
}
204 No Content