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
Create a merchant account
Create a new merchant account in an instance.
POST
/
merchant-accounts
Copy
Ask AI
using Gr4vy;
using Gr4vy.Models.Components;
var sdk = new Gr4vySDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");
MerchantAccountCreate req = new MerchantAccountCreate() {
AccountUpdaterEnabled = true,
Id = "merchant-12345",
DisplayName = "Example",
};
var res = await sdk.MerchantAccounts.CreateAsync(req);
// handle response
Copy
Ask AI
{
"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"
}
This endpoint requires the merchant-accounts.write
scope.
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
Response
201
application/json
Successful Response
The response is of type object
.
Was this page helpful?
Copy
Ask AI
using Gr4vy;
using Gr4vy.Models.Components;
var sdk = new Gr4vySDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");
MerchantAccountCreate req = new MerchantAccountCreate() {
AccountUpdaterEnabled = true,
Id = "merchant-12345",
DisplayName = "Example",
};
var res = await sdk.MerchantAccounts.CreateAsync(req);
// handle response
Copy
Ask AI
{
"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"
}
Assistant
Responses are generated using AI and may contain mistakes.