INFORMAÇÃO
INFORMAMOS QUE ESTÁ DISPONÍVEL NOVA DOCUMENTAÇÃO DA API, ESTA ATUALIZAÇÃO PROPORCIONA UMA FORMA AINDA MAIS SIMPLIFICADA E EFICIENTE DE INTEGRAR OS NOSSOS SERVIÇOS.
CONSULTAR NOVA DOCUMENTAÇÃO
O que é o PINPAY?
O serviço PINPAY, disponibilizado pela ifthenpay, é uma solução inovadora que simplifica e agiliza o processo de pagamento de faturas, serviços, compras e outras transações. O elemento central deste serviço é a utilização de um código PIN que, após validação, direciona o utilizador para a escolha do método de pagamento desejado, fornecendo toda a informação necessária, para concluir o pagamento de forma segura.
Mais informações em https://www.pinpay.pt
Integração da API via POST:
URL do EndPoint:
https://api.ifthenpay.com/gateway/pinpay/[GATEWAY_KEY]
* Substituir a [GATEWAY_KEY] pela enviada pela Ifthenpay.
Formato do pedido em Json (Body)
{
"id": "1234",
"amount": "21.50",
"description": "Encomenda 123",
"lang": "en",
"expiredate": "",
"accounts": "MBWAY|XXX-000000;11686|000;MB|BEM-700700;...",
"selected_method": "2",
"btnCloseUrl": "http://url.com",
"btnCloseLabel": "Texto do Botão",
"success_url": "https://empresa.com/sucess",
"error_url": "https://empresa.com/error",
"cancel_url":"https://empresa.com/cancel"
}
id: (obrigatório) Máximo 15 caracteres numéricos que identifiquem o número da encomenda/fatura/documento/cliente. Caso a sua gateway PayByLink utilize referências Multibanco por algoritmo / Offline, apenas poderá utilizar no máximo de 4 caracteres numéricos.
amount: (obrigatório) Separador decimal "." (ex: "21.50")
description: (opcional) Breve descrição do pagamento. Máximo 200 caracteres.
lang: (opcional) Idioma apresentado ao cliente no momento do checkout (pt, en, es, fr). Default "pt".
expiredate: (opcional) Data de expiração do url no formato AAAAMMDD (20211203) *
accounts: (opcional) Métodos disponíveis para pagamento. (ex: ENTIDADE|SUBENTIDADE;MB|MB-KEY;MBWAY|MBWAY-KEY;PAYSHOP|PAYSHOP-KEY;CCARD|CCARD-KEY). Poderá utilizar o * (asterisco) na vez do | (pipe) (exemplo: CCARD*CCARD-KEY;PAYSHOP*PAYSHOP-KEY)
selected_method: (opcional) Método de pagamento selecionado ou "aberto". (Valores: 1,2,3 ou 4. Correspondências 1-Multibanco, 2-MBWay, 3-Payshop e 4-Cartão de Crédito)
btnCloseUrl : (opcional) URL para o botão de Fechar.
btnCloseLabel : (opcional) Para definir outro texto para o botão de Fechar.
success_url: (opcional) URL de redirecionamento em caso de pagamento efetuado com sucesso.
error_url: (opcional) URL de redirecionamento em caso de erro a processar o pagamento.
cancel_url: (opcional) URL de redirecionamento em caso de cancelamento do processamento do pagamento por parte do utilizador.
Formato da Resposta
{
"PinCode": "1234567890",
"RedirectUrl": "https://gateway.ifthenpay.com/url/r54aiUE1dX"
}
* As referências multibanco por algoritmo não têm validade, ou seja, são sempre válidas e caso o cliente registe as mesmas pode usar as mesmas posteriormente. Caso integre referências multibanco a pedido por API, se a validade solicitada para o link for superior a 31 dias, a validade da referência multibanco vai ser de 45, 60, 90, 120, 180, 365 ou 730 Dias, o sistema irá aplicar por excesso o valor aproximo.
Exemplo: Caso gere um Link com referência multibanco a pedido por API com 42 dias de validade, esta vai ter 45 dias de validade.
CALLBACK (Webhook)
Pode definir um url de callback e uma chave antiphishing com a ifthenpay. Sempre que ocorrer um pagamento esse url será invocado e poderá ler as informações do pagamento no mesmo:
Exemplo de URL de Callback:
Exemplo de URL de Callback invocado (após pagamento confirmado):
Suporte:
A IFTHENPAY garante assistência técnica gratuita a todos os clientes e podem ser utilizados os seguintes canais:
- Através do e-mail suporte@ifthenpay.com
- Através do telefone: 808 222 777 | +351 227 660 871
- Através da abertura de um ticket aqui