DocsTestar a Sua Integração
Configure o seu ambiente de teste e utilize credenciais de teste
Antes de passar a produção, utilize um website sandbox da Cost+ para verificar que a sua integração funciona corretamente. Não existe um URL de sandbox separado — utiliza o mesmo endpoint da API de produção (https://api.costplus.online/v1) com uma chave API de um website sandbox.
Obter a Sua Chave API de Teste
- Inicie sessão no Portal do Comerciante
- Navegue até Websites
- Crie um novo website e selecione Sandbox como tipo, ou selecione um website sandbox existente
- Clique em Integração para encontrar a sua chave API
- Utilize esta chave API na sua integração — todas as transações serão simuladas
O modo sandbox versus produção é determinado inteiramente pelo tipo de website no Portal do Comerciante, não pelo URL da API. A chave API de um website sandbox processa transações simuladas; a chave API de um website de produção processa pagamentos reais. Ambos utilizam o mesmo endpoint da API.
Números de Cartão de Teste
Utilize os números de cartão abaixo para simular diferentes cenários de pagamento. Não utilize números de cartão reais em modo de teste.
| Número do Cartão | CVV | Bandeira | Resultado |
|---|---|---|---|
4111111111111111 | qualquer | Visa | Sucesso |
5544330000000037 | qualquer | Mastercard | Sucesso |
4462030000000000 | qualquer | Visa | Sucesso |
4111111111111105 | qualquer | Visa | Do Not Honor |
4111111111111143 | qualquer | Visa | Stolen Card |
4111111111111151 | qualquer | Visa | Insufficient Funds |
Utilize qualquer data de validade futura e qualquer CVC de 3 dígitos.
Os números de cartão de teste apenas funcionam em modo sandbox. Submetê-los com uma chave API de website de produção resultará numa transação recusada.
Códigos de Erro
Quando uma transação falha, a API devolve um dos seguintes códigos de erro no campo reason da transação:
| Código de Erro | Descrição |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | Autenticação 3DS não concluída a tempo; pagamento cancelado |
ERROR_CARD_CVV_NOT_VALID | CVV corretamente formatado mas não válido |
ERROR_CARD_INFORMATION_NOT_VALID | Informação do cartão corretamente formatada mas não válida |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Transação não suportada para eCommerce |
ERROR_CARD_NOT_VALID | ID do cartão não é válido |
ERROR_CARD_TYPE_DISABLED | Tipo de cartão desativado |
ERROR_TRANSACTION_FAILED | Transação com cartão falhou |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Rejeitado pelo processador (inclui código numérico Visa/MC) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Tipo de transação não permitido pelo vendedor |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Não suportado pela rede de cartões |
INVALID_CARD_CVV | CVV não reconhecido |
INVALID_CARD_NUMBER | Número do cartão não reconhecido |
Erros Comuns de Validação da API
Estes erros são devolvidos como 400 Bad Request quando o pedido à API é inválido:
| Erro | Descrição |
|---|---|
| Unknown payment method | Forneceu um nome de método de pagamento incorreto |
| No permissions for payment method | A sua chave API (projeto) não tem permissões para o método de pagamento especificado |
| Payment method not enabled | O método de pagamento não foi ativado para a sua chave API (projeto) |
| Payment method not supported | A sua chave API (projeto) não tem o estado correto para utilizar o método de pagamento especificado |
Se receber "Payment method not enabled" ou "No permissions", verifique a configuração do método de pagamento no Portal do Comerciante nas definições do seu website.