Quickstart: Make a bank transfer payment with Payments API v1

Use our bank environment in sandbox to facilitate end-to-end testing of the Payments API v1 and associated user journeys.

Make a single immediate payment with our Payments API v1:

  1. Sign up to our Console and get your client_id and client_secret.
  2. Make a POST /connect/token call to exchange the code you get from your Console for an access_token.
  3. Set up a single immediate payment, specifying recipient and amount.
  4. Select your bank to make the payment by following the authorisation link.

See Payments V1 Overview for more information including about supported countries.

Build with Postman

Step 1 - Sign up

  1. Sign up to our Console > App settings and get your client_id and client_secret.
  2. Download our sandbox Postman collection. It contains sample requests so that you can quickly retrieve data and generate code snippets in various languages of your choice.

Step 2 - Obtain an access token

  1. Open the first step in the Postman collection and select the Body tab.
  2. Set client_id and client_secret to your sandbox application's values.
  3. Select Send to send the request to our server.

You’ll receive an access_token in the response. Copy this value to your clipboard.

Step 3 - Make a bank transfer payment

  1. Go to the second step in the Postman collection > Authorization.
  2. Set access_token to the value you got in the response in Step 2.
  3. Go to the Body tab and replace the values with the actual payment details. Make sure redirect_uri is one of the URIs that has been whitelisted in the TrueLayer Console.
  4. Select Send to send the request to our server.
  5. Open the auth_uri in a browser to complete the payment.
  6. Use the customer number 123456789012 and follow the hints above the password input fields to complete authentication.

Step 4 - Get Payment Status

  1. Go to the third step in the Postman collection > Authorization.
  2. Set access_token to the value you got in the response in Step 2.
  3. Replace PAYMENT-ID-HERE in the URI with the value of simp_id you got from the response in Step 3.
  4. Select Send to send the request to our server. We will return the status for this payment.

Did this page help you?