Wise Platform

https://docs.wise.com/
Admin
Wise Platform enables businesses to integrate cross-border payments, multi-currency accounts, and...
Tokens:570,184
Snippets:3,942
Trust Score:10
Update:4 weeks ago
Show doc for...
Tokens:
Raw
### Get Payin Response Example

Source: https://docs.wise.com/guides/product/send-money/funding/direct-debit/create-payin

Example JSON response for a successful get payin request. Shows a settled payin with a reference and null failure reason.

```json
{
  "id": "67136333-0b4d-4f72-49bf-24088f687416",
  "amount": 123.45,
  "currency": "GBP",
  "status": "SETTLED",
  "paymentInstrumentId": "67133810-d4f6-47b4-a948-09b2d8438b43",
  "payinSessionId": "8d63a219-eb86-42c7-a785-02875c281507",
  "reference": "PAY0001",
  "failureReason": null
}
```

--------------------------------

### SOURCE_OF_WEALTH_INFO submissionData JSON example

Source: https://docs.wise.com/guides/product/kyc/wise-kyc/kyc-requirement-types

Example JSON for the SOURCE_OF_WEALTH_INFO requirement. Includes hasSecondaryIncome, secondaryIncomeType, secondaryIncomeDescription, amount, and currency fields.

```json
{
  "data": {
	"hasSecondaryIncome": true,
	"secondaryIncomeType": "SALARY",
	"secondaryIncomeDescription": null,
	"amount": 20000.00,
	"currency": "USD"
  },
  "version": "V1",
  "kycReviewId": "93a903ea-636c-4c86-a25c-cf6d2bd00e81"
}
```

--------------------------------

### submissionData example for useCaseCountries

Source: https://docs.wise.com/guides/product/kyc/wise-kyc/kyc-requirement-types

Example JSON payload for submissionData, including useCaseCountries, version, and kycReviewId.

```json
{
  "data": {
    "useCaseCountries": ["usa", "gbr", "deu"]
  },
  "version": "V1",
  "kycReviewId": "93a903ea-636c-4c86-a25c-cf6d2bd00e81"
}
```

--------------------------------

### submissionData example for ACCOUNT_INTENT

Source: https://docs.wise.com/guides/product/kyc/wise-kyc/kyc-requirement-types

JSON example of the submissionData field for the ACCOUNT_INTENT requirement type. The example uses the value PAYING_FOR_GOODS_OR_SERVICES_ABROAD and includes version and kycReviewId fields.

```json
{
  "data": {
    "accountIntent": "PAYING_FOR_GOODS_OR_SERVICES_ABROAD"
  },
  "version": "V1",
  "kycReviewId": "93a903ea-636c-4c86-a25c-cf6d2bd00e81"
}
```

--------------------------------

### TAX_RESIDENCY submissionData JSON example

Source: https://docs.wise.com/guides/product/kyc/wise-kyc/kyc-requirement-types

Example JSON string for the submissionData field, showing the taxInfoList array with a taxCountry value. The example includes the version and kycReviewId fields. Note that the source example appears to be truncated and may not be a complete valid JSON object.

```json
"data": {
  "taxInfoList": [
    "taxCountry": "SG"
  },
  "version": "V1",
  "kycReviewId": "93a903ea-636c-4c86-a25c-cf6d2bd00e81"
```

--------------------------------

### INCOME submissionData example

Source: https://docs.wise.com/guides/product/kyc/wise-kyc/kyc-requirement-types

JSON example for the INCOME requirement type, showing the data object with amount, currency, incomeType, and incomeExplanation fields, along with version and kycReviewId.

```json
{
  "data": {
	"amount": 50000.00,
	"currency": "USD",
	"incomeType": "SALARY",
	"incomeExplanation": null
  },
  "version": "V1",
  "kycReviewId": "93a903ea-636c-4c86-a25c-cf6d2bd00e81"
}
```

--------------------------------

### PROOF_OF_TRADING_ADDRESS submissionData example

Source: https://docs.wise.com/guides/product/kyc/wise-kyc/kyc-requirement-types

JSON string example for the submissionData field in a PROOF_OF_TRADING_ADDRESS KYC requirement. It shows the required structure with documentType and tradingAddressId.

```json
{
  "data": {
    "documentType": "UTILITY_BILL",
    "tradingAddressId": 4711
  },
  "version": "V1",
  "kycReviewId": "93a903ea-636c-4c86-a25c-cf6d2bd00e81"
}
```

--------------------------------

### submissionData JSON example for BUSINESS_SOURCE_OF_WEALTH_PROOF

Source: https://docs.wise.com/guides/product/kyc/wise-kyc/kyc-requirement-types

Example of the submissionData JSON string for the BUSINESS_SOURCE_OF_WEALTH_PROOF requirement. It includes the sourceOfWealthType, documentType, version, and kycReviewId fields.

```json
{
  "data": {
    "sourceOfWealthType": "REVENUE",
    "documentType": "SAVINGS_STATEMENT"
  },
  "version": "V1",
  "kycReviewId": "93a903ea-636c-4c86-a25c-cf6d2bd81e"
}
```

--------------------------------

### SOURCE_OF_FUNDS submissionData JSON example

Source: https://docs.wise.com/guides/product/kyc/wise-kyc/kyc-requirement-types

Example JSON for the SOURCE_OF_FUNDS requirement. The category field accepts values like SALARY, INVESTMENT, etc., and explanation is required when category is OTHER.

```json
{
  "data": {
	"category": "SALARY",
	"explanation": null
  },
  "version": "V1",
  "kycReviewId": "93a903ea-636c-4c86-a25c-cf6d2bd00e81"
}
```

--------------------------------

### BUSINESS_ANNUAL_INCOME submissionData JSON example

Source: https://docs.wise.com/guides/product/kyc/wise-kyc/kyc-requirement-types

JSON example for the BUSINESS_ANNUAL_INCOME requirement. The amount must be greater than zero and the currency uses a code like USD or EUR.

```json
{
  "data": {
    "amount": 4500.00,
    "currency": "USD"
  },
  "version": "V1",
  "kycReviewId": "93a903ea-636c-4c86-a25c-cf6d2bd00e81"
}
```

--------------------------------

### ANNUAL_VOLUME submissionData JSON example

Source: https://docs.wise.com/guides/product/kyc/wise-kyc/kyc-requirement-types

JSON example for the ANNUAL_VOLUME requirement. The amount must be greater than zero and the currency uses a code like USD or EUR.

```json
{
  "data": {
	"amount": 10000.00,
	"currency": "USD"
  },
  "version": "V1",
  "kycReviewId": "93a903ea-636c-4c86-a25c-cf6d2bd00e81"
}
```

--------------------------------

### Business Use Case Submission Data Example

Source: https://docs.wise.com/guides/product/kyc/wise-kyc/kyc-requirement-types

JSON string example for the submissionData field in a BUSINESS_USE_CASE request. It includes the useCases array with accepted values and the version and kycReviewId fields.

```json
{
  "data": {
    "useCases": ["DONATION", "PAYING_RENT_OR_UTILITIES"]
  },
  "version": "V1",
  "kycReviewId": "93a903ea-636c-4c86-a25c-cf6d2bd00e81"
}
```

--------------------------------

### BUSINESS_SHAREHOLDER_CONTACT_DETAILS submissionData example

Source: https://docs.wise.com/guides/product/kyc/wise-kyc/kyc-requirement-types

Example JSON for the BUSINESS_SHAREHOLDER_CONTACT_DETAILS requirement. The data object contains an array of shareholder contact details, each with a shareholderId and email. The version and kycReviewId fields are also required.

```json
{
  "data": {
    "businessShareholderContactDetails": [
      {
        "shareholderId": "7ff6c4998a59d71ad9834041727017d2",
        "email": "shareholder-one@example.com"
      },
      {
        "shareholderId": "a9578a5a0544d06fd737566c627518a4",
        "email": "shareholder-two@example.com"
      }
    ]
  },
  "version": "V1",
  "kycReviewId": "93a903ea-636c-4c86-a25c-cf6d2bd00e81"
}
```

--------------------------------

### Example Authorization Request

Source: https://docs.wise.com/guides/developer/open-banking

Use this URL to initiate the authorization flow. All parameters are mandatory except state and nonce, which are optional but must match the JWT if present. The request parameter is a JWT Request Object.

```shell
https://wise-sandbox.com/openbanking/authorize?
  response_type=code%20id_token&
  redirect_uri=https://ob-dummy-tpp/redirect&
  scope=openid%20accounts&
  client_id=ob-dummy-tpp&
  state=state123&
  nonce=nonce123&
  request=eyJ0...sYjmjJg
```

--------------------------------

### Response - Get FaceTec public key (200 text/plain)

Source: https://docs.wise.com/guides/developer/auth-and-security/sca-over-api

Example response body for the Get FaceTec public key endpoint. The public key is returned in plain text format.

```clike
-----BEGIN PUBLIC KEY-----
Public Key Content
-----END PUBLIC KEY-----
```

--------------------------------

### POST /v2/quotes - Example Request

Source: https://docs.wise.com/guides/product/send-money/use-cases/affiliates

Use this curl command to create a quote and retrieve pricing and speed information. The request includes target currency, target amount, and source currency. The response includes fees and estimated delivery time.

```shell
curl -i -X POST \
  https://api.wise.com/2026Q3/quotes \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479' \
  -d '{
    "targetCurrency": "GBP",
    "targetAmount": 600,
    "sourceCurrency": "EUR"
  }'
```
Tokens:
Raw