POST
/
merchant-accounts
curl --request POST \
  --url https://api.{gr4vy_id}.gr4vy.app/merchant-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "plantly-uk",
  "display_name": "Plantly UK",
  "outbound_webhook_url": "https://www.example.com/webhook",
  "outbound_webhook_username": "gr4vy",
  "outbound_webhook_password": "super-secret-password",
  "visa_network_tokens_requestor_id": "e50fa0da-903d-4d54-aacc-4cac57d48df2",
  "visa_network_tokens_app_id": "ca12b3d0-4e23-41a9-906f-e5cbb8e6a731"
}'
{
  "type": "merchant-account",
  "id": "plantly-uk",
  "display_name": "Plantly UK",
  "outbound_webhook_url": "https://www.example.com/webhook",
  "outbound_webhook_username": "gr4vy",
  "visa_network_tokens_requestor_id": "e50fa0da-903d-4d54-aacc-4cac57d48df2",
  "visa_network_tokens_app_id": "ca12b3d0-4e23-41a9-906f-e5cbb8e6a731",
  "created_at": "2022-02-01T14:20:00.000+00:00",
  "updated_at": "2022-02-01T14:20:00.000+00:00"
}

This endpoint requires the merchant-accounts.write scope.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

A request to create a merchant account.

Response

201
application/json
Returns the created merchant account.

The response is of type object.