curl "https://sandbox.core.linkio.world/api/payments/methods?currency=GHS" \
-H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
-H "API-Version: 2026-10-29-atlas"
{
"status": "success",
"message": "GHS payment methods retrieved",
"currency": "GHS",
"count": 2,
"methods": [
{
"method": "momo",
"label": "Mobile money",
"verify_account": false,
"fields": [
{ "type": "text", "key": "account_name", "label": "Account holder name", "min_length": 2, "max_length": 100 },
{
"type": "select",
"key": "bank_code",
"label": "Network",
"options": [
{ "value": "0004", "label": "MTN" },
{ "value": "0006", "label": "VODAFONE" }
]
},
{ "type": "text", "key": "account_number", "label": "Mobile money number", "format": "digits", "min_length": 10, "max_length": 12, "hint": "10-12 digits" }
]
}
]
}
Lookups
List payment methods
Get the payout methods for a currency, and the exact fields each one needs.
GET
/
payments
/
methods
curl "https://sandbox.core.linkio.world/api/payments/methods?currency=GHS" \
-H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
-H "API-Version: 2026-10-29-atlas"
{
"status": "success",
"message": "GHS payment methods retrieved",
"currency": "GHS",
"count": 2,
"methods": [
{
"method": "momo",
"label": "Mobile money",
"verify_account": false,
"fields": [
{ "type": "text", "key": "account_name", "label": "Account holder name", "min_length": 2, "max_length": 100 },
{
"type": "select",
"key": "bank_code",
"label": "Network",
"options": [
{ "value": "0004", "label": "MTN" },
{ "value": "0006", "label": "VODAFONE" }
]
},
{ "type": "text", "key": "account_number", "label": "Mobile money number", "format": "digits", "min_length": 10, "max_length": 12, "hint": "10-12 digits" }
]
}
]
}
Requires the Ramps, banks & methods scope (methods read). Use this to build your payout form, so it always matches what we accept.
Headers
string
default:"2026-10-29-atlas"
required
Your account’s API version.
Query
string
required
For example
NGN or GHS.Response
200 OK
string
successstring
For example
GHS payment methods retrieved.string
The currency.
integer
How many methods.
array
Show each method
Show each method
string
For example
bank_transfer or momo.string
A readable name, for example
Mobile money.boolean
true if we check the account with the bank before paying.array
The fields to send in
payment_details.details. Each has a key, label, and type (text or select). Text fields may have min_length, max_length, format, and hint. Select fields have options, each with a value and label.Errors
| Status | Code | Why |
|---|---|---|
422 | validation_failed | Unsupported currency. |
curl "https://sandbox.core.linkio.world/api/payments/methods?currency=GHS" \
-H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
-H "API-Version: 2026-10-29-atlas"
{
"status": "success",
"message": "GHS payment methods retrieved",
"currency": "GHS",
"count": 2,
"methods": [
{
"method": "momo",
"label": "Mobile money",
"verify_account": false,
"fields": [
{ "type": "text", "key": "account_name", "label": "Account holder name", "min_length": 2, "max_length": 100 },
{
"type": "select",
"key": "bank_code",
"label": "Network",
"options": [
{ "value": "0004", "label": "MTN" },
{ "value": "0006", "label": "VODAFONE" }
]
},
{ "type": "text", "key": "account_number", "label": "Mobile money number", "format": "digits", "min_length": 10, "max_length": 12, "hint": "10-12 digits" }
]
}
]
}
Last modified on October 29, 2026
Was this page helpful?