initiate a payment via TrueLayer Payments (PIS)

domain: truelayer.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Enable the payments product in the TrueLayer Console and ensure your application has the payments scope; obtain a client_credentials access token by posting to the token endpoint with grant_type=client_credentials.
  2. Create a payment by POSTing to the payments API endpoint with a JSON body specifying amount_in_minor (pence/cents), currency, payment_method (bank_transfer), beneficiary details (account number and sort code or IBAN), and a unique idempotency_key header.
  3. Receive the payment_id and a resource_token from the creation response; use the resource_token (not your main access token) to initialise the TrueLayer Payments hosted UI or direct payment flow.
  4. Redirect or embed the TrueLayer hosted payment page passing the resource_token so the user can select their bank and authorise the payment via SCA.
  5. After the user completes authorisation, they are redirected to your return_uri; retrieve the final payment status by polling GET /payments/{payment_id} using your client_credentials token until status is 'executed' or a terminal failure state.
  6. Subscribe to payment webhooks to receive asynchronous status updates (e.g., authorized, executed, failed) rather than relying solely on polling.

Known gotchas

Related routes

Initiate a TrueLayer payment using Payments API v3 with provider selection and beneficiary verification
docs.truelayer.com · 6 steps · unrated
Create and authorize a TrueLayer VRP sweeping mandate and initiate individual sweep payments
docs.truelayer.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans