Guides
Start typing to search…

Requirement for External Bank Accounts

This guide outlines the required bank account fields depending on the user's country and account type.

Europe

Common Fields

  • bank.iban
  • bank.bic
  • bank.address.countryCode

Individual

  • owner.firstName
  • owner.lastName
  • owner.email
{
  "accountType": "EXTERNAL_BANK_ACCOUNT",
  "bank": {
    "iban": "FR1420041010050500013M02606",
    "bic": "BNPAFRPP",
    "address": {
      "countryCode": "FR"
    }
  },
  "owner": {
    "firstName": "Jean",
    "lastName": "Dupont",
    "email": "[email protected]"
  }
}

Business

  • owner.businessName
  • owner.email
{
  "accountType": "EXTERNAL_BANK_ACCOUNT",
  "bank": {
    "iban": "FR1420041010050500013M02606",
    "bic": "BNPAFRPP",
    "address": {
      "countryCode": "FR"
    }
  },
  "owner": {
    "businessName": "My Company Ltd",
    "email": "[email protected]"
  }
}

India

💡

ifscCode is mandator

Common Fields

  • bank.name
  • bank.accountNumber
  • bank.ifscCode
  • bank.address.countryCode = "IN"

Individual

  • owner.firstName
  • owner.lastName
  • owner.email
{
  "accountType": "EXTERNAL_BANK_ACCOUNT",
  "bank": {
    "name": "State Bank of India",
    "accountNumber": "1234567890",
    "ifscCode": "SBIN0001234",
    "address": {
      "countryCode": "IN"
    }
  },
  "owner": {
    "firstName": "Raj",
    "lastName": "Kumar",
    "email": "[email protected]"
  }
}

Business

  • owner.businessName
  • owner.email
{
  "accountType": "EXTERNAL_BANK_ACCOUNT",
  "bank": {
    "name": "State Bank of India",
    "accountNumber": "1234567890",
    "ifscCode": "SBIN0001234",
    "address": {
      "countryCode": "IN"
    }
  },
  "owner": {
    "businessName": "Tech Solutions Pvt Ltd",
    "email": "[email protected]"
  }
}

Pakistan

Common Fields

  • bank.name
  • bank.accountNumber or IBAN
  • bank.address.countryCode = "PK"

Individual

  • owner.firstName
  • owner.lastName
  • owner.email
{
  "accountType": "EXTERNAL_BANK_ACCOUNT",
  "bank": {
    "name": "Allied Bank Limited",
    "accountNumber": "1234567890123",
    "address": {
      "countryCode": "PK"
    }
  },
  "owner": {
    "firstName": "Ahmed",
    "lastName": "Ali",
    "email": "[email protected]"
  }
}

Business

  • owner.businessName
  • owner.email
{
  "accountType": "EXTERNAL_BANK_ACCOUNT",
  "bank": {
    "name": "Allied Bank Limited",
    "accountNumber": "1234567890123",
    "address": {
      "countryCode": "PK"
    }
  },
  "owner": {
    "businessName": "Tech Corp Pakistan",
    "email": "[email protected]"
  }
}

Philippines

Common Fields

  • bank.name
  • bank.accountNumber
  • bank.address.countryCode = "PH"

Individual

  • owner.firstName
  • owner.lastName
  • owner.email
{
  "accountType": "EXTERNAL_BANK_ACCOUNT",
  "bank": {
    "name": "BDO Unibank",
    "accountNumber": "1234567890",
    "address": {
      "countryCode": "PH"
    }
  },
  "owner": {
    "firstName": "Maria",
    "lastName": "Santos",
    "email": "[email protected]"
  }
}

Business

  • owner.businessName
  • owner.email
{
  "accountType": "EXTERNAL_BANK_ACCOUNT",
  "bank": {
    "name": "BDO Unibank",
    "accountNumber": "1234567890",
    "address": {
      "countryCode": "PH"
    }
  },
  "owner": {
    "businessName": "Manila Trading Inc",
    "email": "[email protected]"
  }
}

Indonesia

Common Fields

  • bank.name
  • bank.accountNumber
  • bank.address.countryCode = "ID"

Individual

  • owner.firstName
  • owner.lastName
  • owner.email
{
  "accountType": "EXTERNAL_BANK_ACCOUNT",
  "bank": {
    "name": "Bank Mandiri",
    "accountNumber": "1234567890",
    "address": {
      "countryCode": "ID"
    }
  },
  "owner": {
    "firstName": "Budi",
    "lastName": "Santoso",
    "email": "[email protected]"
  }
}

Business

  • owner.businessName
  • owner.email
{
  "accountType": "EXTERNAL_BANK_ACCOUNT",
  "bank": {
    "name": "Bank Mandiri",
    "accountNumber": "1234567890",
    "address": {
      "countryCode": "ID"
    }
  },
  "owner": {
    "businessName": "Jakarta Solutions PT",
    "email": "[email protected]"
  }
}

Nigeria

💡 bank.code is mandatory and validated automatically.

Common Fields

  • bank.code
  • bank.accountNumber
  • bank.address.countryCode = "NG"

Individual

  • owner.firstName
  • owner.lastName
  • owner.email
{
  "accountType": "EXTERNAL_BANK_ACCOUNT",
  "bank": {
    "code": "058",
    "accountNumber": "1234567890",
    "address": {
      "countryCode": "NG"
    }
  },
  "owner": {
    "firstName": "Chukwu",
    "lastName": "Okafor",
    "email": "[email protected]"
  }
}

Business

  • owner.businessName
  • owner.email
{
  "accountType": "EXTERNAL_BANK_ACCOUNT",
  "bank": {
    "code": "058",
    "accountNumber": "1234567890",
    "address": {
      "countryCode": "NG"
    }
  },
  "owner": {
    "businessName": "Lagos Enterprises Ltd",
    "email": "[email protected]"
  }
}

Updated 25 days ago