Flow description

Step 1: Initiate Single Payment

  1. At first, you have to obtain a valid access token to initiate a payment. You are able to do that by doing POST /auth/oauth/v2/token request with client credentials grant type and with PISP scope. 
  2. Your application connects to the bank that services the PSU's payment account and creates a new payments resource. This informs the bank that one of its clients intends to make a payment. The bank responds with an identifier for the resource (orderId – which is the intent identifier).
  3. This step is carried out by making one of the POST payments requests, e.g. POST /api/v1/payments/standard/sba request to the payments resource.

Step 2: Authorize Single Payment Consent

  1. You should redirect the bank client to the bank by making a GET /auth/oauth/v2/authorize request. The redirect includes the OrderId generated in the previous step. This allows the bank to correlate the payment that was initiated. The bank authenticates the bank client and updates the state of the payments resource internally to indicate that the payment has been authorized.
  2. The bank client is redirected back to you.
  3. You are now able to obtain a valid access token to submit an authorized payment. You are able to do that by doing POST /auth/oauth/v2/token request with authorization code grant type and with payments scope. Once you obtained a valid access token to initiate authorized payment, you may proceed to step 3.

Step 3: Submit Initiated Payment

  1. Once the bank client is redirected to you, you create a payment-submissions resource to indicate that the payment created in the steps above should be submitted for processing.
  2. This is carried out by making a POST /api/v1/payments/submission request to the payment-submissions resource.
  3. The bank return the payment submission status to you.

Step 4: Get Payment Submission Status

  1. You can check the status of the initiated payment (with the OrderId).
  2. This is carried out by making a GET /api/v1/paymments/{orderId}/status request to the initiated payments resource.

Payment Flow Diagram