Introduction
Transactions
Buyers
Checkout Sessions
Payment links
Payment options
Refunds
Settlement records
Instruments
- Card schemes
- Card details
- Digital wallets
- Gift cards
- Payment methods
- Payment method definitions
Vault
- Account updater
- Network tokens
- Payment service tokens
- Vault Forward
- Vault Forward endpoints
- Vault Forward authentication
Connections
- All services
- Payment services
- Digital wallets
- Anti-fraud services
- Gift-card services
Other
- Flow
- Merchant accounts
- Reports
- Report executions
- Webhook subscriptions
List all merchant accounts
List all merchant accounts in an instance.
GET
/
merchant-accounts
Copy
Ask AI
using Gr4vy;
using Gr4vy.Models.Components;
using Gr4vy.Models.Requests;
var sdk = new Gr4vySDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");
ListMerchantAccountsResponse? res = await sdk.MerchantAccounts.ListAsync(limit: 20);
while(res != null)
{
// handle items
res = await res.Next!();
}
Copy
Ask AI
{
"items": [
{
"type": "merchant-account",
"id": "merchant-12345",
"display_name": "John Doe",
"outbound_webhook_url": "https://example.com/callback",
"outbound_webhook_username": "user-12345",
"outbound_webhook_password": "password-12345",
"loon_client_key": "client-key-1234",
"loon_secret_key": "key-12345",
"loon_accepted_schemes": [
"visa"
],
"account_updater_request_encryption_key": "key-1234",
"account_updater_request_encryption_key_id": "key-id-1234",
"account_updater_response_decryption_key": "key-1234",
"account_updater_response_decryption_key_id": "key-id-1234",
"account_updater_enabled": true,
"over_capture_amount": 1299,
"over_capture_percentage": 25,
"visa_network_tokens_requestor_id": "id-12345",
"visa_network_tokens_app_id": "id-12345",
"amex_network_tokens_requestor_id": "id-12345",
"amex_network_tokens_app_id": "id-12345",
"mastercard_network_tokens_requestor_id": "id-12345",
"mastercard_network_tokens_app_id": "id-12345",
"created_at": "2013-07-16T19:23:00.000+00:00",
"updated_at": "2013-07-16T19:23:00.000+00:00"
}
],
"limit": 20,
"next_cursor": "ZXhhbXBsZTE",
"previous_cursor": "Xkjss7asS"
}
This endpoint requires the merchant-accounts.read
scope.
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
A pointer to the page of results to return.
Examples:
"ZXhhbXBsZTE"
The maximum number of items that are at returned.
Required range:
1 <= x <= 100
Examples:
20
The search term to filter merchant accounts by.
Examples:
"merchant-12345"
Response
200
application/json
Successful Response
The response is of type object
.
Was this page helpful?
Copy
Ask AI
using Gr4vy;
using Gr4vy.Models.Components;
using Gr4vy.Models.Requests;
var sdk = new Gr4vySDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");
ListMerchantAccountsResponse? res = await sdk.MerchantAccounts.ListAsync(limit: 20);
while(res != null)
{
// handle items
res = await res.Next!();
}
Copy
Ask AI
{
"items": [
{
"type": "merchant-account",
"id": "merchant-12345",
"display_name": "John Doe",
"outbound_webhook_url": "https://example.com/callback",
"outbound_webhook_username": "user-12345",
"outbound_webhook_password": "password-12345",
"loon_client_key": "client-key-1234",
"loon_secret_key": "key-12345",
"loon_accepted_schemes": [
"visa"
],
"account_updater_request_encryption_key": "key-1234",
"account_updater_request_encryption_key_id": "key-id-1234",
"account_updater_response_decryption_key": "key-1234",
"account_updater_response_decryption_key_id": "key-id-1234",
"account_updater_enabled": true,
"over_capture_amount": 1299,
"over_capture_percentage": 25,
"visa_network_tokens_requestor_id": "id-12345",
"visa_network_tokens_app_id": "id-12345",
"amex_network_tokens_requestor_id": "id-12345",
"amex_network_tokens_app_id": "id-12345",
"mastercard_network_tokens_requestor_id": "id-12345",
"mastercard_network_tokens_app_id": "id-12345",
"created_at": "2013-07-16T19:23:00.000+00:00",
"updated_at": "2013-07-16T19:23:00.000+00:00"
}
],
"limit": 20,
"next_cursor": "ZXhhbXBsZTE",
"previous_cursor": "Xkjss7asS"
}
Assistant
Responses are generated using AI and may contain mistakes.