Create a draft payment
Before you begin, ensure that you've got an access token.
For information about getting the access token, see Tutorial: Create your first draft payment.
Then, you can use the /draft_payments
endpoint to create a draft payment on behalf of a user, and the draft payment appears in the user account where they can approve or reject.
In addition, you can use this endpoint to make multiple draft payments by creating new rows for new drafts with the supported CSV format shown in the following tables.
For each draft payment request you make, ensure that the same currency is used.
Upon a successful request for multiple draft payments, you receive a DraftPaymentID
that represents all the draft payments associated with this request.
Please note that the maximum number of rows in a CSV file is 50 and all the payments must be in the same currency.
Download an example CSV file.
For the format of the CSV file, check the request body details.
See also Tutorials: Work with draft payments.
Authorization
Each Open Banking API must contain an authorization header in the following format to make a call: Bearer <yourAccessToken>
.
Before you start, ensure that you've got an access token with the correct scope
using the /token
endpoint.
You need to get the authorization code first and exchange it for an access token.
Never share your access_token
with anyone, as it can be used to access the banking data that you have access to and initiate transactions.
For more information, see Tutorial: Get account and transaction information and Tutorial: Initiate your first payment as examples.
x-jws-signature
Open Banking API Payment requests additionally require a JSON Web Signature (JWS) which needs to be added to the header of the request. The JWS signature must be obtained using the full content of the payload.
Request
For the format of the CSV file, check the tables above.
Response
Draft Payment Details