Airwallex logo

Account Capability

Copy for LLMView as Markdown

The Account Capability resource represents capabilities you can enable or query on your Airwallex account like accepting card payments or making fund transfers.

Endpoints
GET /api/v1/account_capabilities/{id}
POST /api/v1/account_capabilities/{id}/enable
GET /api/v1/account_capabilities/funding_limits

Get capability by ID

GET /api/v1/account_capabilities/{id}

Get the status of a capability by providing the capability unique identifier.

Parameters
idrequiredstring

id

Response body - 200 OK
commentstring

Additional details about the status of this capability.

detailsobject

Details of this capability.

details.reason_codesarray

Specific codes that indicate the reason a capability is disabled. For more information on the codes related to payment method capabilities, refer to this page .

entity_typestring

The type of entity of your declarant, one of INDIVIDUAL, BUSINESS

idstring

A unique identifier of the requested capability.

statusstring

The status of this capability, one of ENABLED, DISABLED, PENDING.

updated_atstring

Last time this capability has been updated.

Errors
Error statusDescription
400

["capability_not_supported" ]

401

Possible errors: credentials_invalid, credentials_expired

429

Too many requests

500

Service unavailable

GET /api/v1/account_capabilities/{id}
$curl --request GET \
> --url 'https://api.sandbox.airwallex.com/api/v1/account_capabilities/account_capability_id' \
> --header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
> --header 'Content-Type: application/json'
Response (200 OK)
1{
2 "comment": "<string>",
3 "details": {
4 "reason_codes": []
5 },
6 "entity_type": "INDIVIDUAL",
7 "id": "transfer_cny_local",
8 "status": "ENABLED",
9 "updated_at": "2023-04-01T11:25:39+0000"
10}
Was this section helpful?

Enable a capability

POST /api/v1/account_capabilities/{id}/enable

Submit a request to enable a specific capability for your Airwallex account.

Parameters
idrequiredstring

A unique identifier of the requested capability, transfer_cny_local for transfer CNY local, or one of payments_mastercard, payments_klarna, payments_jcb, payments_amex, payments_giropay, payments_googlepay, payments_applepay, payments_wechat, payments_unionpay, payments_visa, payments_ideal, payments_bancontact, payments_sofort, payments_bacs_direct_debit, payments_airwallex_pay, payments_alipaycn, payments_alipayhk, payments_blik, payments_boost, payments_dana, payments_diners, payments_discover, payments_doku_ewallet, payments_dragonpay, payments_duit_now, payments_eps, payments_fps, payments_gcash, payments_grabpay_my, payments_grabpay_sg, payments_kakaopay, payments_konbini, payments_korean_local_card, payments_mybank, payments_naver_pay, payments_online_banking_kr, payments_online_banking_ph, payments_online_banking_th, payments_p24, payments_pay_now, payments_payco, payments_payeasy, payments_paysafecard, payments_paysafecash, payments_prompt_pay, payments_rabbit_line_pay, payments_sam_kiosk, payments_samsung_pay, payments_seven_eleven_my, payments_seven_eleven_tw, payments_shopee_pay, payments_skrill, payments_tesco_lotus, payments_tng, payments_truemoney, payments_trustly, payments_ach_direct_debit, payments_alfamart, payments_atome, payments_axs_kiosk, payments_bank_transfer_id, payments_bank_transfer_kr, payments_bitpay, payments_eft_direct_debit, payments_enets, payments_esun, payments_family_mart, payments_fpx, payments_go_pay, payments_hi_life, payments_indomaret, payments_jenius_pay, payments_linkaja, payments_maxima, payments_multibanco, payments_narvesen, payments_online_banking_ee, payments_online_banking_lt, payments_online_banking_lv, payments_ovo, payments_paybybankapp, payments_paypal, payments_paypost, payments_paysera, payments_payu, payments_perlas_terminals, payments_permata_atm, payments_satispay, payments_sepa_direct_debit, payments_upi, payments_zip, payments_line_pay, payments_paypay, payments_payeasy_atm, payments_toss_pay, payments_spei, payments_venmo, payments_afterpay, payments_payto, payments_birdpay, payments_twint, payments_bank_transfer, payments_cash_app_pay, payments_lumi, payments_pix, payments_seven_eleven_jp, payments_payme, payments_jkopay, payments_shopee_pay_id, payments_shopee_pay_sg, payments_shopee_pay_th, payments_shopee_pay_ph, payments_shopee_pay_vn, payments_shopee_pay_my, payments_spaylater_id, payments_spaylater_my, payments_spaylater_sg, payments_spaylater_th, payments_spaylater_ph, payments_spaylater_vn, payments_bc, payments_hana, payments_hyundai, payments_kb, payments_lotte, payments_nh, payments_samsung, payments_shinhan, payments_woori, payments_laybuy, payments_tabby, payments_octopus, payments_wero, payments_airi, payments_affirm, payments_bizum, payments_swish, payments_cartes_bancaires, payments_mbway for payment methods.

Request body

Returns an empty JSON object

Response body - 200 OK
commentstring

Additional details about the status of this capability.

detailsobject

Details of this capability.

details.reason_codesarray

Specific codes that indicate the reason a capability is disabled. For more information on the codes related to payment method capabilities, refer to this page .

entity_typestring

The type of entity of your declarant, one of INDIVIDUAL, BUSINESS

idstring

A unique identifier of the requested capability.

statusstring

The status of this capability, one of ENABLED, DISABLED, PENDING.

updated_atstring

Last time this capability has been updated.

Errors
Error statusDescription
400

["bad_request" ,"field_required" "invalid_person" ]

401

Possible errors: credentials_invalid, credentials_expired

429

Too many requests

500

Service unavailable

POST /api/v1/account_capabilities/{id}/enable
$curl --request POST \
> --url 'https://api.sandbox.airwallex.com/api/v1/account_capabilities/account_capability_id/enable' \
> --header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
> --header 'Content-Type: application/json' \
> --data '{
> "enroll_sme_program": true,
> "id": "payments_mastercard"
>}'
Response (200 OK)
1{
2 "comment": "string",
3 "details": {
4 "reason_codes": [
5 "string"
6 ]
7 },
8 "entity_type": "INDIVIDUAL",
9 "id": "payments_mastercard",
10 "status": "ENABLED",
11 "updated_at": "2023-04-01T11:25:39+0000"
12}
Was this section helpful?

Get funding limits

GET /api/v1/account_capabilities/funding_limits

Before initiating a Direct Debit from a Linked Account or as a Funding Source, you may wish to query the available funding limit or Faster Direct Debit limit.

Parameters
ccystring

Specify the currency the limit will be displayed in. A single limit is applied for the entire customer, regardless of the display currency.

effective_atstring

the timestamp at which the customer's funding limit becomes effective

mandate_typestring

the settlement method or clearing system

page_numinteger

Page number

page_sizeinteger

Page size

Response body - 200 OK
has_moreboolean

A flag which identifies whether there are more results.

itemsarray

Paged results.

items.currencystring

Currency of the limit, it's the applied one, or default as per your owning entity

items.limitnumber

The upper limit.

items.statusstring

Current setting status.

ACTIVE
REQUESTED
items.typestring

Deposit type, possible values are DIRECT_DEBIT, FASTER_DIRECT_DEBIT.

DIRECT_DEBIT_DEPOSIT
FASTER_DIRECT_DEBIT_DEPOSIT
items.availablesobject

The remaining limit of direct debit schemas, possible keys are SAME_DAY_ACH, NEXT_DAY_ACH, FEDWIRE, BECS, NPP, BACS, SEPA, FPS, FAST, GIRO, BECS, EFT.

items.effective_atstring

the timestamp at which the customer's funding limit becomes effective

items.mandate_typestring

the settlement method or clearing system

items.requested_limitnumber

The under evaluating limit.

items.updated_atstring

Last update time.

Errors
Error statusDescription
401

Possible errors: credentials_invalid, credentials_expired

429

Too many requests

500

Service unavailable

GET /api/v1/account_capabilities/funding_limits
$curl --request GET \
> --url 'https://api.sandbox.airwallex.com/api/v1/account_capabilities/funding_limits' \
> --header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
> --header 'Content-Type: application/json'
Response (200 OK)
1{
2 "has_more": false,
3 "items": [
4 {
5 "availables": {
6 "SAME_DAY_ACH": "25000",
7 "NEXT_DAY_ACH": "12000"
8 },
9 "currency": "USD",
10 "effective_at": "2022-08-22T01:23:00+0000",
11 "limit": 30000,
12 "mandate_type": "US_ACH_DEBIT",
13 "requested_limit": 100000,
14 "status": "ACTIVE",
15 "type": "DIRECT_DEBIT_DEPOSIT",
16 "updated_at": "2022-08-22T01:23:00+0000"
17 }
18 ]
19}
Was this section helpful?