Integração com o seu serviço

Criar pedido

Usar método public/exchanger/order/create

Você pode encontrar a documentação para o sistema de autorização no seu gabinete pessoal. Mais sobre o trabalho com métodos e dados adicionais pode ser encontrado no

IPN (Notificação sobre a mudança de status do pedido de pagamento)

Para receber uma notificação de alteração de status de pedido ao criar um pedido, você precisa enviar parâmetros adicionais:

• clientCallbackUrl - um callback quando o pedido for concluído, o cliente verá um botão para retornar ao site e será redirecionado para este URL
• hideOutData - ocultar os detalhes do destinatário
• ipnUrl - Link HTTP/HTTPS para notificar o seu servidor.
• ipnSecret - String aleatória para criar uma assinatura de solicitação (para manter a integridade da solicitação)

1. A solicitação será enviada pelo método POST
2. O IPN será enviado uma vez
3. A entrega do IPN não é garantida (se o servidor não responder à solicitação, ela não será reenviada)

Exemplo de IPN

• POST
• ['Content-Type'] = 'application/x-www-form-urlencoded'



• orderUID :Number() - pedido uid
• orderId :String(ObjectId) -pedido id
• newStatus :String() - pedido status atual
• inAmount :String(number) - order in sum
• outAmount :String(number) - order out sum
• xml_from :String() - pedido uid
• xml_to :String() - pedido uid
• timestamp :Number() - tempo unix da notificação IPN
• toValues :Array([{key,name,value}]) - requisitos do pedido

Lista de status

• new - novo pedido
• waitPayment - aguardando pagamento do usuário
• errorPayment - erro no pagamento do usuário (comerciante envia erro)
• inProgress - em andamento (aguardando admin ou pagamento do pedido)
• inProgressPayout - em fila para pagamento (pagamento aceito com sucesso) (se configurado em moeda de pagamento automático, será iniciado)
• errorPayout - erro no pagamento (ocorreu erro durante o pagamento)
• hold - congelado (problemas com o pedido)
• done - pedido concluído com sucesso
• returned - o pedido foi pago, mas nem todas as condições da troca foram cumpridas, e os meios são devolvidos ao remetente
• deleted - pedido excluído (cancelado)

Verificação do checksum da solicitação (IPN)

sha256(orderId:newStatus:inAmount:outAmount:xml_from:xml_to:timestamp:ipnSecret)

        
const stringForHash = orderId+":"+newStatus+":"+inAmount+":"+outAmount+":"+xml_from+":"+xml_to+":"+timestamp+":"+ipnSecret;
// example string for hash 5d8e6002b80b7b4cd75a6424:inProgress:2:317.42:ETH:WMZ:1571328406072:SECRET123

const hash = crypto.createHash('sha256').update(stringForHash).digest('hex')
// example hash af3acf947e6f0e0f2c267e300b8582e504dba12d1f2d058652b7414163c09f48
        
      

Controle de pagamento

1. Se você precisar controlar o status dos pedidos, crie-os usando autorização, então todos os pedidos serão refletidos no seu gabinete pessoal;
2. Você pode salvar o UID do pedido e a chave secreta e acessar o pedido manualmente especificando esses dados na barra de endereços

Pagamento

1. Você pode usar /payment/ para mostrar a página de pagamento
   
   // schema
https://bcx.exchange/user-lang/payment/order-uid/order-secret
// example result
https://bcx.exchange/en/payment/1409/dGqwF2M2eBPaSN1G5ljMS1cb
2. Também pode simplesmente fornecer um link para a troca, conforme visto por todos os clientes, de acordo com o mesmo esquema especificado na primeira variante, exceto que /payment/ deve ser substituído por /order/
3. Há parâmetros no método que permitem exibir os dados de pagamento ou o formulário de pagamento no seu site. IMPORTANTE: se o método for com pagamento manual, você precisará atualizar o status do pedido de waitPayment para inProgress após o pagamento.