API
Skip to main content

Payment with ATM

To start a payment with an ATM, you only need to generate a 9-digit reference and provide it to the consumer.

O processo funciona da seguinte forma:

  1. Generation of ATM reference;
  2. The user pays the reference at the ATM/Homebanking machine;
  3. SIBS communicates confirmation to PayPay;
  4. PayPay notifies the status of the payment;

The following flow illustrates how the payment via ATM works:

MB flow

1. Generation of ATM reference​

POST /payments/references

{
	"type": "payment",
	"amount": 100,
	"callbackUrl": "https://teste.pt", // Opcional se usar webhooks
	"availableMethods": [
		{
			"code": "MB",
			"type": "NORMAL" // Ou REALTIME
		}
	],
	"validDate": {
		"start": "2022-04-01T14:45:56+00:00",
		"end": "2022-04-30T23:59:59+01:00"
	}
}

2. The user pays the reference​

If the user has specified a callback URL or Webhook a notification will be sent.

3. View payment status​

GET ​/payments/{id} 

{
	"apiVersion": "1.4.0",
	"date": "2022-03-09T14:45:56+00:00",
	"success": true,
	"data": {
		"id": "50438",
		"type": "payment",
		"referenceDetails": {
			"entity": "12797",
			"reference": "002492617"
		},
		"stateDetails": {
			"state": "confirmed",
			"createdAt": "2021-10-07T18:07:46+01:00"
		},
		"amount": 100,
		"createdAt": "2022-03-09T14:45:56+00:00",
		"updatedAt": "2022-03-09T14:45:56+00:00",
		"validDate": {
			"start": "2022-04-01T14:45:56+00:00",
			"end": "2022-04-30T23:59:59+01:00"
		},
		"availableMethods": [
			{
				"code": "MB",
				"type": "NORMAL",
				"name": "Multibanco"
			}
		]
	}
}