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



Em alternativa ou em complemento ao callback (webhook) pode ler os pagamentos efetuados utilizando um webservice. O webservice para ler os pagamentos efetuados está disponível no seguinte endereço:


 

https://ifthenpay.com/ifmbws/ifmbws.asmx

 

 

Os métodos getPayments, getPaymentsJson e getPaymentsXml devolvem os pagamentos efetuados na entidade e subentidade indicada.

A única diferença entre os três métodos é o formato em que a informação é devolvida. No primeiro (getPayments) é devolvido no formato SOAP (1.1 e 1.2); No segundo (getPaymentsJson) é devolvido em formato JSON; e no terceiro (getPaymentsXml) é devolvido em formato puro XML.

 

Os parâmetros a passar na chamada do método são:

  • Chavebackoffice: Chave fornecida pela IFTHENPAY na assinatura do contrato. Obrigatório.
  • Entidade: Entidade (5 dígitos) ou MB ou MBWAY ou PAYSHOP ou CCARD . Facultativo.
  • Subentidade: Subentidade (3 dígitos) ou MB Key ou MBWAY Key ou PAYSHOP Key ou CCARD Key fornecida pela IFTHENPAY na assinatura do contrato. Facultativo.
  • dtHrInicio: Data/Hora inicial dos pagamentos pretendidos no formato dd-MM-yyyy HH:mm:ss. Facultativo.
  • dtHrFim: Data/Hora final dos pagamentos pretendidos no formato dd-MM-yyyy HH:mm:ss. Facultativo.
  • Referencia: Referência multibanco (9 dígitos) sobre a qual se pretende saber a informação do pagamento. Facultativo.
  • Valor: Valor em euros dos pagamentos que se pretende obter informação. Facultativo.
  • Sandbox: Devem indicar 1 ou 0 no caso de utilizarem ou não a plataforma de testes. Obrigatório.

 

O método pode ser chamado de várias formas, conforme as necessidades:


  • Se pretende obter todos os pagamentos efetuados por referencia multibanco offline (geradas por algoritmos) entre duas datas/horas deverá passar os parâmetros chavebackoffice, entidade, subentidade, dtHrInicio, dtHrFim e sandbox. Todos os outros deverão ser deixados em branco. 
Exemplo:
https://ifthenpay.com/ifmbws/ifmbws.asmx/getPayments?chavebackoffice=0000-0000-0000-0000&entidade=11604&subentidade=999&dtHrInicio=23-05-2012 00:00:00&dtHrFim=23-05-2012 23:59:59&referencia=&valor=&sandbox=0 

 

Devolve os pagamentos da entidade 11604, subentidade 999 com a chave de backoffice 0000-0000-0000-0000 efetuados no dia 23-05-2012 entre as 00h00m00s e as 23h59m59s. 

NOTA: Deverá utilizar a sua chave, entidade e subentidade e não as indicadas neste exemplo.

 

 

  • Se pretende apenas saber se uma determinada entidade/referência/valor foi paga deverá passar os parâmetros chavebackoffice, entidade, subentidade, referencia, valor e sandbox e opcionalmente a dtHrInicio e dtHrFim
Exemplo:
https://ifthenpay.com/ifmbws/ifmbws.asmx/getPayments?chavebackoffice=0000-0000-0000-0000&entidade=11604&subentidade=999&dtHrInicio=&dtHrFim=&referencia=999123420&valor=10.25&sandbox=0

 

Devolve, caso existam, os pagamentos efetuados na entidade, referência e valor indicados. Ter em atenção que podem existir mais do que um pagamento dessa referência. Podem também ser passados os parâmetros da data/hora inicial e final. 

 

  • Se pretende obter todos os pagamentos efetuados entre duas datas/horas por referencias multibanco a pedido (API) deverá passar os parâmetros chavebackoffice, entidade, subentidade, dtHrInicio, dtHrFim e sandbox. Todos os outros deverão ser deixados em branco. 
Exemplo:
https://ifthenpay.com/ifmbws/ifmbws.asmx/getPayments?chavebackoffice=0000-0000-0000-0000&entidade=MB&subentidade=AAA-000000&dtHrInicio=23-05-2012 00:00:00&dtHrFim=23-05-2012 23:59:59&referencia=&valor=&sandbox=0 

 

Devolve os pagamentos das referencias multibanco pedidas e pagas com a chave de backoffice 0000-0000-0000-0000 efetuados no dia 23-05-2012 entre as 00h00m00s e as 23h59m59s. 

NOTA: Deverá utilizar a sua chave, entidade deve ser MB e na subentidade usar a sua MB KEY e não as indicadas neste exemplo.

 

  • Se pretende obter todos os pagamentos efetuados entre duas datas/horas por MBWAY (API) deverá passar os parâmetros chavebackoffice, entidade, subentidade, dtHrInicio, dtHrFim e sandbox. Todos os outros deverão ser deixados em branco. 
Exemplo:
https://ifthenpay.com/ifmbws/ifmbws.asmx/getPayments?chavebackoffice=0000-0000-0000-0000&entidade=MBWAY&subentidade=AAA-000000&dtHrInicio=23-05-2012 00:00:00&dtHrFim=23-05-2012 23:59:59&referencia=&valor=&sandbox=0 

 

Devolve os pagamentos das referencias multibanco pedidas e pagas com a chave de backoffice 0000-0000-0000-0000 efetuados no dia 23-05-2012 entre as 00h00m00s e as 23h59m59s. 

NOTA: Deverá utilizar a sua chave, entidade deve ser MBWAY e na subentidade usar a sua MBWAY KEY e não as indicadas neste exemplo.

Estes métodos devolvem a seguinte informação para cada pagamento (1 ou mais):

  • Entidade – entidade utilizada no pagamento ou MB ou MBWAY ou PAYSHOP ou CCARD(string)
  • Sub_Entidade - subentidade utilizada no pagamento ou MB Key ou MBWAY Key ou PAYSHOP Key ou CCARD Key  (string)
  • Referencia – referência multibanco paga (9 dígitos) ou v/referencia para os restante pagamentos por API
  • Valor – valor pago em euros
  • Id – id utilizado na geração da referência multibanco (4 dígitos) ou v/ID para os restante pagamentos por API
  • DtHrPagamento – data/hora do pagamento em formato dd-MM-yyyy HH:mm:ss
  • Processamento – data de processamento yyyyMMdd1
  • Terminal – terminal utilizado no pagamento
  • Tarifa – tarifa do serviço
  • ValorLiquido – valor pago deduzido da tarifa
  • CodigoErro – código de erro
  • MensagemErro – mensagem de erro


Código

Mensagem

0

Sucesso.

1

Não existem pagamentos.

2

Erro nas Datas/Horas.

3

Chave inválida.

9

Erro desconhecido.