Começo rápido
solicitação ao HOST
Para obter detalhes, consulte as informações de abertura de conta ou consulte a equipe.
Estrutura da solicitação
Ao enviar uma solicitação HTTP POST para o endereço do servidor da API Starpago e adicionar os parâmetros de solicitação correspondentes ao corpo HTTP de acordo com a estrutura da solicitação, o sistema Starpago responde aos parâmetros de retorno de acordo com os parâmetros da solicitação.
Protocolo de comunicação
Para maior segurança, a interface API Starpago suporta apenas comunicação de solicitações pelo canal HTTPS. Ao chamar a API do sistema Starpago, siga os seguintes requisitos de segurança:
Todas as solicitações devem usar SSL, caso contrário a solicitação será rejeitada. Somente TLS 1.2 ou TLS 1.1 é compatível. SSLv3 e TLS 1.0 não são suportados.
Codificação de caracteres
Os resultados da solicitação e do retorno são codificados usando o conjunto de caracteres UTF-8.
Formato do parâmetro
Os parâmetros de solicitação e os parâmetros de retorno estão no formato JSON.
Tipo de conteúdo: application/json; conjunto de caracteres=utf-8
Parâmetro de retorno
| campo | O nome do | instruções |
|---|---|---|
| code | Código de estado | Código de status HTTP. O valor deste campo indica apenas o status das solicitações de interface, mas não indica que os parâmetros do serviço estão normais |
| msg | Descrição do estado | Descrição do resultado da invocação da interface |
| error | A mensagem de erro | Informações de exceção |
| data | Valor de retorno comercial | O valor de retorno que descreve a invocação de negócios. Para obter detalhes, consulte o valor dos dados de cada interface na interface de negócios |
Mecanismo de Notificação
O aviso pode ser dividido de duas maneiras. Devido à possibilidade de operação de simulação do usuário em callback síncrono, ou o usuário fechar manualmente o navegador quando a notificação síncrona não for redirecionada, o que pode causar prejuízo ao lojista, sugerimos fortemente ao lojista que confirme o resultado do pagamento do pedido junto ao resultado de notificação assíncrona.
Retorno de chamada síncrono
Após o pagamento bem sucedido, ou cancelamento do pagamento, o Starpago redireciona o navegador do consumidor para o Returnurl fornecido pelo comerciante com os parâmetros relevantes. O retorno de chamada síncrono usa GET para saltar, e os parâmetros de emenda correspondentes serão processados por URLencode codificado como UTF-8 para cada valor de parâmetro e, em seguida, saltar.
Retorno de chamada assíncrono
O Starpago enviará a mensagem de resultado do pagamento do consumidor para o notifyurl fornecido pelo comerciante por meio do servidor, e carregará os parâmetros relevantes, e os enviará na forma de post. O comerciante precisa julgar o status do pedido no resultado para determinar o status do pedido.
Ao receber a solicitação, o servidor do estabelecimento comercial deverá responder com HTTP 200 e imprimir SUCESSO ou OK. Se o feedback do comerciante para o Starpago não tiver 7 caracteres (SUCESSO) ou 2 caracteres (OK), o servidor Starpago reenviará continuamente a notificação até que 24 horas e 47 minutos tenham se passado. Em casos gerais, 25 horas completam nove vezes o reenvio do aviso (observe que o intervalo de frequência é comumente: 30 s, 2 m, 4 m, 10 m, 30 m, 1 h, 2 h, 6 h, 15 h). Em alguns casos, um comerciante pode receber várias notificações do Starpago para um único pedido, e o comerciante precisará verificar sua lógica para poder processar exclusivamente pedidos que possam receber notificações repetidas de status de sucesso ou falha.