Pagamentos
Os eventos de pagamento devem ser enviados na API de integração do FT CRM.
Conector RabbitMQ
Conector Kafka
API REST
Propriedades da Mensagem RabbitMQ
| chave | valor |
|---|---|
tipo | PAGAMENTO |
O tipo é esperado como uma propriedade (mas não no payload) da Mensagem RabbitMQ. Qualquer cabeçalho será ignorado.
Cabeçalhos da Mensagem Kafka
| chave | valor |
|---|---|
tipo | PAGAMENTO |
⬆️ POST /v1/integration/payment
- Este endpoint permitirá que você acione com base em depósitos e saques.
- Esses eventos contribuem para o modelo de segmentação para qualquer atividade de pagamento por exemplo, Contagem de Depósitos, Última Data de Depósito, Valor Médio de Depósito.
- Você pode publicar essa mensagem tanto quando o pagamento foi iniciado quanto quando foi concluído, quanto mais status fornecidos, melhor.
- O mínimo necessário para enviar são eventos de depósitos aprovados.
Observações
exchange_rate - Caso a moeda do evento não seja a Moeda Base, o exchange_rate precisa ser enviado para converter o valor de volta para a Moeda Base multiplicando o valor pelo exchange_rate. Isso garantirá que a segmentação esteja correta em uma única moeda, caso várias sejam usadas.
status - Solicitado, Aprovado, Rejeitado, Rollback, Cancelado.
Um evento de pagamento Solicitado pode ser seguido por um evento Aprovado, Rejeitado ou Cancelado para o mesmo payment_id. Se um pagamento Aprovado for revertido, um evento de pagamento com o mesmo payment_id e status Rollback deve ser enviado. Em termos de dados de segmentação:
- Sempre que um evento de pagamento com tipo Crédito e status Aprovado for recebido, o valor do depósito do jogador é aumentado pelo valor especificado no evento.
- Sempre que um evento de pagamento com tipo Crédito e status Rollback for recebido, o valor do depósito do jogador é diminuído pelo valor especificado no evento.
- Sempre que um evento de pagamento com tipo Débito e status Aprovado for recebido, o valor do saque do jogador é aumentado pelo valor especificado no evento.
- Sempre que um evento de pagamento com tipo Débito e status Rollback for recebido, o valor do saque do jogador é diminuído pelo valor especificado no evento.
Se você planeja enviar Rollback como status, informe seu gerente de integração.
Exemplo de Payload
Tipo de Dados
As propriedades obrigatórias estão marcadas com *
| Chave | Valor de Exemplo | Descrição |
|---|---|---|
amount * | 32.76 | Valor |
bonus_code | "", "CHRISTMAS2023" | Código de bônus |
currency * | "USD" | Moeda da transação no formato ISO 4217 |
exchange_rate * | 0.91 | A taxa de câmbio no momento da transação. |
fee_amount * | 2.34 | Valor da taxa, se não aplicável, enviar 0 |
note | por exemplo, "insufficient_funds" | Notas úteis |
origin * | "sub.example.com" | A Origem |
payment_id * | "23541" | ID da plataforma do pagamento |
status * | "Aprovado", "Solicitado", "Rejeitado", "Rollback", "Cancelado" | Status do pagamento. Selecione um valor da lista de opções fornecida |
timestamp * | "2015-03-02T8:27:58.10Z" | Timestamp do pagamento no formato RFC3339 |
type * | "Crédito" (Depósito)
"Débito" (Saque) | Tipo de pagamento. Selecione um valor da lista de opções fornecida |
user_id * | "7865312321" | ID do usuário |
vendor_id * | "562" | ID da plataforma do fornecedor |
vendor_name | "Skrill" | Nome da plataforma do fornecedor |