API OVERVIEW
CORE
- Auth
- Balances
ISSUING
- Cards
- Products
- Cardholders
- Transactions
PAYOUT
Webhooks
- Payout
- Beneficiary
Query a beneficiary
This endpoint query a beneficiary.
curl --location 'http://api.sandbox.uqpay.org/api/v1/beneficiaries/query?account_currency=USD&account_number=accadfgtrg31da&payment_method=local&entity_type=company&company_name=lark%E9%80%9A%E7%9F%A5&beneficiary_id=null&bank_country=null&email=admin%40gmail.com&first_name=null&last_name=null' \
--header 'x-client-id: RxxlL413omk6gqqn2jpg7J' \
--header 'x-auth-token: Bearer 4739e82520d26a115a5a77703cb3a04e'
{
"code": 200,
"message": "Success",
"data": {
"beneficiary_id": "c45a4e8e-5969-4609-8218-091f5db7287e",
"entity_type": "company",
"payment_method": "swift",
"beneficiary_email": "[email protected]",
"beneficiary_nickname": "MANY A-SUN",
"beneficiary_company_name": "Courtesy Hardware Store",
"beneficiary_summary": "USD account ending in 4557",
"account_currency_code": "USD",
"bank_country_code": "US",
"beneficiary_bank_details": {
"bank_name": "1ST STATE BANK",
"bank_address": "4929 Briarwood Drive",
"bank_country_code": "US",
"account_holder": "Robert Shishani",
"account_currency_code": "USD",
"account_number": "4865393923574557",
"iban": "",
"swift_code": "230",
"clearing_system": "SWIFT",
"routing_code_type1": "",
"routing_code_value1": "",
"routing_code_type2": "",
"routing_code_value2": ""
},
"beneficiary_address": {
"country_code": "US",
"city": "Montgomery",
"street_address": "1230 Stafford Dr",
"postal_code": "36117",
"state": "Alabama"
}
}
}
Header
x-client-id.
Bearer YOUR_TOKEN_HERE.
Parameters
Number of the account this beneficiary is associated with.
Maximum length 60
Payment method of the beneficiary.
One of local, swift
Beneficiary UUID.
Two-letter ISO 3166-2 country code.
Entity type of the beneficiary.
One of individual, company
Email of the beneficiary.
First name of the beneficiary.
Maximum length 45
Last name of the beneficiary.
Maximum length 45
Company name of the beneficiary.
Maximum length 120
Response
Indicates whether the call was successful. 200 if successful, 400 if not.
Response Message. “Success” if successful, others not.
ID of the beneficiary.
Entity type of the beneficiary.
One of company, individual
The payment method needs to be specified to ensure that accurate banking details are captured and validated for the specified payment method. This is required for timely and accurate delivery of funds to the beneficiary account.
Email of the beneficiary.
Nickname of the beneficiary.
Company name of the beneficiary.
Summary of the beneficiary.
Bank country code.
Two-letter ISO 3166-2 country code.
First name of the beneficiary.
Last name of the beneficiary.
Beneficiary’s bank account details where the payment will be credited.
Bank name of the beneficiary’s bank account.
Bank street address.
Bank country code.
Two-letter ISO 3166-2 country code.
Account holder name of the beneficiary’s bank account.
Number of the account this beneficiary is associated with.
International bank account number, mostly for european countries.
Bank swift code.
Supported clearing systems to remit incoming funds to the account.
Routing code type.
Routing code value.
Routing code sub type.
Routing code sub type value.
curl --location 'http://api.sandbox.uqpay.org/api/v1/beneficiaries/query?account_currency=USD&account_number=accadfgtrg31da&payment_method=local&entity_type=company&company_name=lark%E9%80%9A%E7%9F%A5&beneficiary_id=null&bank_country=null&email=admin%40gmail.com&first_name=null&last_name=null' \
--header 'x-client-id: RxxlL413omk6gqqn2jpg7J' \
--header 'x-auth-token: Bearer 4739e82520d26a115a5a77703cb3a04e'
{
"code": 200,
"message": "Success",
"data": {
"beneficiary_id": "c45a4e8e-5969-4609-8218-091f5db7287e",
"entity_type": "company",
"payment_method": "swift",
"beneficiary_email": "[email protected]",
"beneficiary_nickname": "MANY A-SUN",
"beneficiary_company_name": "Courtesy Hardware Store",
"beneficiary_summary": "USD account ending in 4557",
"account_currency_code": "USD",
"bank_country_code": "US",
"beneficiary_bank_details": {
"bank_name": "1ST STATE BANK",
"bank_address": "4929 Briarwood Drive",
"bank_country_code": "US",
"account_holder": "Robert Shishani",
"account_currency_code": "USD",
"account_number": "4865393923574557",
"iban": "",
"swift_code": "230",
"clearing_system": "SWIFT",
"routing_code_type1": "",
"routing_code_value1": "",
"routing_code_type2": "",
"routing_code_value2": ""
},
"beneficiary_address": {
"country_code": "US",
"city": "Montgomery",
"street_address": "1230 Stafford Dr",
"postal_code": "36117",
"state": "Alabama"
}
}
}
curl --location 'http://api.sandbox.uqpay.org/api/v1/beneficiaries/query?account_currency=USD&account_number=accadfgtrg31da&payment_method=local&entity_type=company&company_name=lark%E9%80%9A%E7%9F%A5&beneficiary_id=null&bank_country=null&email=admin%40gmail.com&first_name=null&last_name=null' \
--header 'x-client-id: RxxlL413omk6gqqn2jpg7J' \
--header 'x-auth-token: Bearer 4739e82520d26a115a5a77703cb3a04e'
{
"code": 200,
"message": "Success",
"data": {
"beneficiary_id": "c45a4e8e-5969-4609-8218-091f5db7287e",
"entity_type": "company",
"payment_method": "swift",
"beneficiary_email": "[email protected]",
"beneficiary_nickname": "MANY A-SUN",
"beneficiary_company_name": "Courtesy Hardware Store",
"beneficiary_summary": "USD account ending in 4557",
"account_currency_code": "USD",
"bank_country_code": "US",
"beneficiary_bank_details": {
"bank_name": "1ST STATE BANK",
"bank_address": "4929 Briarwood Drive",
"bank_country_code": "US",
"account_holder": "Robert Shishani",
"account_currency_code": "USD",
"account_number": "4865393923574557",
"iban": "",
"swift_code": "230",
"clearing_system": "SWIFT",
"routing_code_type1": "",
"routing_code_value1": "",
"routing_code_type2": "",
"routing_code_value2": ""
},
"beneficiary_address": {
"country_code": "US",
"city": "Montgomery",
"street_address": "1230 Stafford Dr",
"postal_code": "36117",
"state": "Alabama"
}
}
}