Skip to content

Create Payee ​

Overview ​

Creating a payee is a preparatory step before making payments. In Onerway's standard payment process, the system requires each recipient to create a unique beneficiaryId, and subsequent payments only need to reference this ID.

Why Create a Payee?

This mechanism ensures that each payee's account information is verified and archived, improving payout accuracy and compliance.

Applicable Scenarios ​

Creating a payee is applicable to the following business scenarios:

ScenarioDescriptionAdvantages
Frequently Used Payee ListPre-establish payment accounts for suppliers, employees, partnersReduce duplicate entry
High-frequency PaymentsEnterprises reuse the same payment account for multiple paymentsImprove efficiency
Batch SettlementsExternal payments, refunds, settlements and other high-frequency scenariosBatch processing

Operation Process ​

Step 1: Collect Basic Payee Information ​

Collect necessary information:

Step 2: Call Payee Field Query Interface ​

Why Query?

Required fields may differ for different countries, currencies, and payment methods, so you need to query and confirm first.

Process:

  1. Call the payee field query interface Payee Required Field Query Interface to query required fields
  2. Get the list of required fields for the country/payment method
  3. Ensure complete payee information is collected

Step 3: Submit Create Request ​

  1. Call the create payee interface Add Payee Interface to submit payee information
  2. System performs verification
  3. Upon passing verification, returns beneficiaryId

Notes

  • Please ensure all required fields are filled in
  • Bank account information must be accurate
  • Payee information must comply with local compliance requirements

Step 4: Initiate Payment Using beneficiaryId ​

  1. Save beneficiaryId
  2. Reference this ID when initiating payment Initiate Payment via Payee ID Interface
  3. No need to fill in payee information again

FAQ ​

Q1: How soon after creating a payee can it be used? ​

Answer

The payee can be used immediately after successful creation.

Q2: Can a payee be used for multiple payments? ​

Answer

Yes. A created payee can be reused indefinitely, which is exactly the advantage of pre-creating payees.

Q3: What if the payee information is filled in incorrectly? ​

Answer

You can modify the information through the update payee interface Update Payee Interface, or delete Delete Payee Interface and recreate.

Q4: Do different currencies require creating different payees? ​

Answer

Yes, for the same payment account, different currencies require creating different beneficiaryIds.

Q5: Do different payment methods require creating different payees? ​

Answer

Yes, for the same payee name, different payment methods require creating different beneficiaryIds.