CardV para Dujiao-Next

Obter sua chave de API ↗

#O que você precisa

Perante os seus clientes, o vendedor é você: você define os preços, responde às dúvidas deles e cuida dos reembolsos.

#Passo 1: Obtenha sua chave de API

Use a chave de API que você já tem no Portal do lojista, em API e webhooks > Chaves de API. Você não precisa de uma chave separada para o Dujiao-Next.

• O ID da chave começa com ck_live_.
• O segredo de assinatura começa com cs_live_. Ele é exibido só uma vez, quando a chave é criada. Se você não o tiver mais, use Gerar novo segredo na chave. O ID da chave continua o mesmo, e o segredo antigo para de funcionar na hora.

Chaves antigas sem ID da chave não podem ser usadas. Nesse caso, crie uma chave nova no Portal.

#Passo 2: Adicione a conexão

No painel do Dujiao-Next, abra Integration > Connection Management > New Connection e preencha o formulário:

A cotação e a margem se combinam assim: preço CardV × cotação × (1 + margem), depois arredondado. Por exemplo, com uma cotação de 7.2 (apenas um exemplo; informe a cotação atual que você consultar) e uma margem de 15%, um cartão de 5.78 USD é vendido por 47.9.

Quando a cotação mudar, atualize-a na conexão e clique em Reapply Markup para atualizar os preços dos produtos que você já importou. Faça o mesmo quando mudar a margem.

#Passo 3: Teste a conexão

Clique em Ping na conexão. Ping succeeded significa que a sua chave funciona, e o status da conexão muda para Active. Se aparecer um erro, veja Solução de problemas.

#Passo 4: Importe produtos

1. Abra Integration > Product Mappings > Import from Upstream e escolha a sua conexão CardV.
2. Navegue por categoria, ou mude para Flat List para escolher produtos avulsos.
3. Escolha uma categoria local, ou marque Auto-create local categories. O produto precisa de uma categoria para poder ser salvo.
4. Importe. Cada produto mantém título, descrição, instruções de resgate e valores de face (como 10 USD).

Os produtos importados ficam fora da vitrine. Confira cada um e depois ative Active no editor do produto.

#Passo 5: Limite a um item por pedido

Em cada produto importado, abra o editor do produto e defina Max purchase quantity como 1.

A CardV entrega um item por pedido. Se um cliente pagar dois códigos em um mesmo pedido, a CardV recusa a compra e você precisa resolver esse pedido manualmente. O Dujiao-Next não consegue receber esse limite da CardV automaticamente, então configure-o você mesmo.

Já no editor, também recomendamos:

• Exibição de estoque na vitrine: escolha Hide quantity. A CardV compra da marca quando chega um pedido, então o número de estoque que a sua loja mostra significa apenas "disponível".
• Imagens: adicione as suas se o produto não tiver nenhuma.

#Como funciona a entrega

1. O cliente paga na sua loja.
2. A sua loja envia a compra para a CardV, e a CardV debita o seu saldo CardV.
3. A sua loja consulta o pedido na CardV. Nos nossos testes, o código chegou em menos de um minuto.
4. O código aparece na página do pedido do cliente como Code, PIN (quando o cartão tem um) e Expires (quando o cartão tem data de validade). É sempre um código, nunca um link.

Recargas diretas. Alguns produtos são creditados direto na conta do cliente no jogo ou no app. No checkout, o cliente preenche os dados que o produto exige, como um ID de jogador ou um número de telefone. Quando a recarga termina, a página do pedido do cliente mostra Top-up completed.

Se a CardV não conseguir entregar. A CardV reembolsa o pedido no seu saldo CardV, e a sua loja marca a compra como cancelada. Depois, você reembolsa ou ajuda o cliente na sua loja.

#O que não está disponível

A lista de importação mostra apenas os produtos que a sua loja pode vender por esta conexão:

• Somente valores de face fixos. Cartões em que o cliente digita o próprio valor não aparecem.
• Não aparecem: recargas de crédito de celular, produtos de pagamento e carteiras, cripto e cartões de pagamento pré-pagos.
• Somente códigos. Produtos que só podem ser entregues como link não aparecem.

Os preços que você vê são os seus próprios preços CardV em USD.

#Lista de IPs permitidos

Se você configurar uma lista de IPs permitidos no Portal do lojista, adicione o endereço IP público do servidor que roda a sua loja Dujiao-Next. Caso contrário, a CardV recusa todas as requisições dele. A mesma chave, a mesma lista de IPs e os mesmos limites de requisições valem para a API da CardV e para o Dujiao-Next.

#Solução de problemas

Estas mensagens aparecem no painel do Dujiao-Next, após o Ping, durante a importação ou em uma compra em Procurement Orders.

#Perguntas frequentes

Preciso de uma nova chave de API para o Dujiao-Next? Não. Use a chave de API assinada que você já tem. Se você também usa a chave na sua própria integração com a API da CardV, as duas compartilham os mesmos limites de requisições.

Por que deixo a Callback URL em branco? A CardV não envia callbacks para lojas. A sua loja Dujiao-Next consulta cada pedido por conta própria até o resultado ser final.

O que acontece quando os preços da CardV mudam? Com Auto-update price on sync ativado, os seus preços de venda são recalculados com a sua cotação e a sua margem na próxima sincronização. Com ele desativado, a sua loja continua vendendo pelo preço antigo.

Onde vejo esses pedidos na CardV? Na página Pedidos do Portal do lojista. A coluna Seu ID de pedido começa com dujiao: seguido do número do subpedido do Dujiao-Next (por exemplo dujiao:DJ…-01). Se você configurou webhooks da CardV, eles também são disparados para esses pedidos.

Posso mudar os títulos, as descrições e as imagens dos produtos? Sim. A sincronização atualiza preços e disponibilidade. Ela não sobrescreve os seus títulos nem as suas imagens.

Posso vender valores personalizados? Ainda não pelo Dujiao-Next. Só estão disponíveis valores de face fixos.

#Suporte

Escreva para [email protected] com o seu Merchant ID, o número do pedido no Dujiao-Next e a mensagem de erro. O uso da CardV está sujeito aos nossos Termos de Serviço.