Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.paysway.io/llms.txt

Use this file to discover all available pages before exploring further.

Bank transfers are difficult because of varying formats and requirements for each country, currency, and payment type. Payment Preparation API helps reduce this complexity by validating and enriching full or partial payment instructions that you send to us as API requests. In response, we output clear validation alerts or additional data necessary to ensure smooth transactions and a better user experience. Additionally, you can verify beneficiary account details using the same payment instruction payload. You likely already have multiple banking integrations with various partners and send them payment instructions in the ISO 20022 messaging standard, which contain a number of different fields.
  • Payer information (name and account number, optionally address or other details like tax identifiers)
  • Currency and amount
  • Beneficiary details (same as for payer)
  • Beneficiary bank details (banking identifier of some type, like a BIC, or sort code, or routing number)
  • Routing inputs (intermediary BICs or type of the payment scheme)
  • Reference, purpose, fees type (optional)
PaySway can consume the same details with minimal changes, because our API is inspired by the same standard that you use in your gateways. When you want to check the correctness of your user’s input, you send a partial or full payment instruction to the validation endpoint as a request. If there are no issues in the input, you’ll get an OK, else one or more alerts will highlight the exact reason. When you want to receive additional input to ensure payment success, you call our enrichment endpoint with the same instruction as in validation. You can use the output of the enriched fields as required in your setup. When you want to verify the beneficiary account details before processing a payment, you can use our account verification endpoint. This asynchronous service confirms account holder names and checks account status across multiple countries. Find the full list of supported corridors here