Native Transaction RFI API
Learn how to use Airwallex's RFI API endpoints to build your own tailored experience for users to handle requests for information (RFI). These endpoints can be used directly for RFIs related to your own account, or RFIs related to your connected accounts (using the x-on-behalf-of header).
Before you begin
- To use RFI APIs for a connected account you will need the Native API OBO (On-Behalf-Of) permission enabled on your account. Please contact your Airwallex Account Manager to enable this if it is not already enabled.
- Obtain your access token API by authenticating to Airwallex using your unique Client ID and API key. You will need the access token to make API calls.
Step 1: Get notified of an information request (RFI)
You can receive RFI notifications via the following two methods:
Option 1: RFI webhook notification
Subscribe to our RFI webhook through the Airwallex web app to be notified when your account or one of your connected accounts receives a request for information.
Option 2: Query the RFI status via API
Call List all RFIs API to get a list of all open Transaction RFIs across your accounts, your own account and connected accounts.
Step 2: Retrieve the RFI details
Call Retrieve an RFI API using the RFI ID returned in Step 1, to retrieve the details of the RFI.
Step 3: Retrieve transaction details
Transaction RFI questions will be linked to a transaction through the sources object in the RFI details. Call the corresponding transaction API using the transaction ID returned in the sources.id field to retrieve details of the transaction.
CHARGE: Retrieve a Charge APITRANSFER: Retrieve a Transfer APIDIRECT_DEBIT: Retrieve a Direct Debit Payout APIDEPOSIT: Retrieve a Deposit APIPAYMENT: Retrieve a Payout API
Step 4: Respond to the RFI
Call Respond to an RFI API to provide the information requested by Airwallex.
Step 5: Handle the response
Listen for status changes to the RFI via webhooks. See RFI events.
Error handling
| Error code | Message | Next steps |
|---|---|---|
invalid_state_for_operation | - | Make sure the RFI status is ACTION_REQUIRED |
account_not_authorised_for_operation | - | Make sure the RFI is linked to the correct account |
resource_not_found | - | Make sure you are using the correct RFI ID when querying |
invalid_argument | Please answer all questions in the request/ Please provide your answers in the right format (TEXT vs ATTACHMENT) | Make sure all the RFI questions are answered / and in the right format |