Fetch Payment Methods

`GET /v1/global-payout/payment-methods`

By default, this endpoint returns all supported payment methods and their method-specific requirements. You can also filter the list by payment method code or name. Destination countries, transaction limits, and delivery timelines are documented in the Supported Countries page — they are not part of this response.

Query parameters

string

Optional payment method code. Use this to retrieve a specific method, for example ACH.

string

Optional payment method name. Use this to retrieve a specific method, for example BANK or Wire Transfer.

Supported method codes are BANK, MobileMoney, INTERAC, FASTER_PAYMENTS, SEPA, ACH, and WIRE.

curl --request GET \
  --url https://api.nomba.com/v1/global-payout/payment-methods \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'

{
  "code": "00",
  "description": "Successful",
  "status": false,
  "data": [
    {
      "code": "BANK",
      "displayName": "Bank Transfer",
      "purposeOfPaymentRequired": false,
      "purposeOfPayments": [],
      "requiredFields": ["accountType"],
      "optionalFields": ["narration"],
      "accountTypes": ["INDIVIDUAL", "CORPORATE"],
      "bankAccountTypes": []
    },
    {
      "code": "MobileMoney",
      "displayName": "Mobile Money",
      "purposeOfPaymentRequired": false,
      "purposeOfPayments": [],
      "requiredFields": ["accountNumber", "institutionName", "accountType"],
      "optionalFields": ["narration"],
      "accountTypes": ["INDIVIDUAL", "CORPORATE"],
      "bankAccountTypes": []
    },
    {
      "code": "INTERAC",
      "displayName": "Interac",
      "purposeOfPaymentRequired": false,
      "purposeOfPayments": [],
      "requiredFields": ["accountType", "beneficiary"],
      "optionalFields": ["narration"],
      "accountTypes": ["INDIVIDUAL", "CORPORATE"],
      "bankAccountTypes": []
    },
    {
      "code": "FASTER_PAYMENTS",
      "displayName": "Faster Payments",
      "purposeOfPaymentRequired": false,
      "purposeOfPayments": [],
      "requiredFields": ["accountNumber", "institutionCode", "accountType"],
      "optionalFields": ["narration"],
      "accountTypes": ["INDIVIDUAL", "CORPORATE"],
      "bankAccountTypes": []
    },
    {
      "code": "SEPA",
      "displayName": "SEPA",
      "purposeOfPaymentRequired": true,
      "purposeOfPayments": ["MAINTENANCE_EXPENSES", "SERVICE_CHARGES"],
      "requiredFields": ["accountNumber", "institutionCode", "accountType", "purposeOfPayment"],
      "optionalFields": ["narration"],
      "accountTypes": ["INDIVIDUAL", "CORPORATE"],
      "bankAccountTypes": []
    },
    {
      "code": "ACH",
      "displayName": "ACH",
      "purposeOfPaymentRequired": true,
      "purposeOfPayments": ["MAINTENANCE_EXPENSES", "SERVICE_CHARGES"],
      "requiredFields": [
        "accountNumber",
        "institutionCode",
        "institutionName",
        "accountType",
        "bankAccountType",
        "bankAddress",
        "bankCity",
        "bankState",
        "bankZipCode",
        "beneficiary",
        "purposeOfPayment"
      ],
      "optionalFields": ["narration"],
      "accountTypes": ["INDIVIDUAL"],
      "bankAccountTypes": ["CHECKING", "SAVINGS"]
    },
    {
      "code": "WIRE",
      "displayName": "Wire Transfer",
      "purposeOfPaymentRequired": true,
      "purposeOfPayments": ["MAINTENANCE_EXPENSES", "SERVICE_CHARGES"],
      "requiredFields": [
        "accountNumber",
        "institutionCode",
        "institutionName",
        "accountType",
        "bankAccountType",
        "bankAddress",
        "bankCity",
        "bankState",
        "bankZipCode",
        "beneficiary",
        "purposeOfPayment"
      ],
      "optionalFields": ["narration"],
      "accountTypes": ["INDIVIDUAL", "CORPORATE"],
      "bankAccountTypes": ["CHECKING", "SAVINGS"]
    }
  ]
}

curl --request GET \
  --url 'https://api.nomba.com/v1/global-payout/payment-methods?code=ACH' \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'

curl --request GET \
  --url 'https://api.nomba.com/v1/global-payout/payment-methods?name=BANK' \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'

curl --request GET \
  --url 'https://api.nomba.com/v1/global-payout/payment-methods?name=Wire%20Transfer' \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'

Response body

array

required

List of supported payment methods.

Hide payment method object

string

The payment method code. Use this as the paymentMethod value in the Authorize Transfer request.

string

Human-readable label suitable for displaying in a UI selector.

boolean

Indicates whether purposeOfPayment is required for this payment method.

array

Selectable purpose-of-payment values for this method. When purposeOfPaymentRequired is true, choose a value from this array.

array

Fields that must be included when authorizing a transfer with this payment method.

array

Fields that may be included but are not required for this payment method.

array

Selectable accountType values for this payment method.

array

Selectable bankAccountType values for this payment method.

Supported Countries

Institution Providers

Introduction

Getting Started

Products

API Basics

Guides

Fetch Payment Methods

Fetch Payment Methods

`GET /v1/global-payout/payment-methods`

Query parameters

Response body

Fetch Payment Methods

​GET /v1/global-payout/payment-methods

​Query parameters

​Response body

`GET /v1/global-payout/payment-methods`

Query parameters

Response body