curl --request PATCH \
  --url https://api.grailpay.com/api/v3/merchants/{uuid} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_reference_id": "reference_12345",
  "billing_merchant_uuid": "6a8fc154-1a50-483b-a690-fd1dfaf9408b",
  "billing_processor_mid": "12345678",
  "payout_type": "batch",
  "beneficial_owners": [
    {
      "first_name": "Jane",
      "last_name": "Doe",
      "dob": "2023-04-11",
      "ssn9": "123456789",
      "address": {
        "line_1": "10554 W Quarles Ave",
        "city": "Littleton",
        "state": "CO",
        "zip": "80127",
        "line_2": "Suite 123"
      },
      "is_beneficial_owner": true,
      "is_director": false,
      "is_significant_control_person": false,
      "ownership_percentage": 25,
      "email": "owner@test.com",
      "phone": "2457856490",
      "occupation": "Co-founder"
    }
  ],
  "bank_account": {
    "plaid_account_id": "<string>",
    "plaid_access_token": "<string>",
    "account_number": "9876543210",
    "routing_number": "021000021",
    "account_name": "John Doe",
    "account_type": "checking"
  },
  "actions": {}
}
'

import requests

url = "https://api.grailpay.com/api/v3/merchants/{uuid}"

payload = {
    "client_reference_id": "reference_12345",
    "billing_merchant_uuid": "6a8fc154-1a50-483b-a690-fd1dfaf9408b",
    "billing_processor_mid": "12345678",
    "payout_type": "batch",
    "beneficial_owners": [
        {
            "first_name": "Jane",
            "last_name": "Doe",
            "dob": "2023-04-11",
            "ssn9": "123456789",
            "address": {
                "line_1": "10554 W Quarles Ave",
                "city": "Littleton",
                "state": "CO",
                "zip": "80127",
                "line_2": "Suite 123"
            },
            "is_beneficial_owner": True,
            "is_director": False,
            "is_significant_control_person": False,
            "ownership_percentage": 25,
            "email": "owner@test.com",
            "phone": "2457856490",
            "occupation": "Co-founder"
        }
    ],
    "bank_account": {
        "plaid_account_id": "<string>",
        "plaid_access_token": "<string>",
        "account_number": "9876543210",
        "routing_number": "021000021",
        "account_name": "John Doe",
        "account_type": "checking"
    },
    "actions": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    client_reference_id: 'reference_12345',
    billing_merchant_uuid: '6a8fc154-1a50-483b-a690-fd1dfaf9408b',
    billing_processor_mid: '12345678',
    payout_type: 'batch',
    beneficial_owners: [
      {
        first_name: 'Jane',
        last_name: 'Doe',
        dob: '2023-04-11',
        ssn9: '123456789',
        address: {
          line_1: '10554 W Quarles Ave',
          city: 'Littleton',
          state: 'CO',
          zip: '80127',
          line_2: 'Suite 123'
        },
        is_beneficial_owner: true,
        is_director: false,
        is_significant_control_person: false,
        ownership_percentage: 25,
        email: 'owner@test.com',
        phone: '2457856490',
        occupation: 'Co-founder'
      }
    ],
    bank_account: {
      plaid_account_id: '<string>',
      plaid_access_token: '<string>',
      account_number: '9876543210',
      routing_number: '021000021',
      account_name: 'John Doe',
      account_type: 'checking'
    },
    actions: {}
  })
};

fetch('https://api.grailpay.com/api/v3/merchants/{uuid}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.grailpay.com/api/v3/merchants/{uuid}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'client_reference_id' => 'reference_12345',
    'billing_merchant_uuid' => '6a8fc154-1a50-483b-a690-fd1dfaf9408b',
    'billing_processor_mid' => '12345678',
    'payout_type' => 'batch',
    'beneficial_owners' => [
        [
                'first_name' => 'Jane',
                'last_name' => 'Doe',
                'dob' => '2023-04-11',
                'ssn9' => '123456789',
                'address' => [
                                'line_1' => '10554 W Quarles Ave',
                                'city' => 'Littleton',
                                'state' => 'CO',
                                'zip' => '80127',
                                'line_2' => 'Suite 123'
                ],
                'is_beneficial_owner' => true,
                'is_director' => false,
                'is_significant_control_person' => false,
                'ownership_percentage' => 25,
                'email' => 'owner@test.com',
                'phone' => '2457856490',
                'occupation' => 'Co-founder'
        ]
    ],
    'bank_account' => [
        'plaid_account_id' => '<string>',
        'plaid_access_token' => '<string>',
        'account_number' => '9876543210',
        'routing_number' => '021000021',
        'account_name' => 'John Doe',
        'account_type' => 'checking'
    ],
    'actions' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.grailpay.com/api/v3/merchants/{uuid}"

	payload := strings.NewReader("{\n  \"client_reference_id\": \"reference_12345\",\n  \"billing_merchant_uuid\": \"6a8fc154-1a50-483b-a690-fd1dfaf9408b\",\n  \"billing_processor_mid\": \"12345678\",\n  \"payout_type\": \"batch\",\n  \"beneficial_owners\": [\n    {\n      \"first_name\": \"Jane\",\n      \"last_name\": \"Doe\",\n      \"dob\": \"2023-04-11\",\n      \"ssn9\": \"123456789\",\n      \"address\": {\n        \"line_1\": \"10554 W Quarles Ave\",\n        \"city\": \"Littleton\",\n        \"state\": \"CO\",\n        \"zip\": \"80127\",\n        \"line_2\": \"Suite 123\"\n      },\n      \"is_beneficial_owner\": true,\n      \"is_director\": false,\n      \"is_significant_control_person\": false,\n      \"ownership_percentage\": 25,\n      \"email\": \"owner@test.com\",\n      \"phone\": \"2457856490\",\n      \"occupation\": \"Co-founder\"\n    }\n  ],\n  \"bank_account\": {\n    \"plaid_account_id\": \"<string>\",\n    \"plaid_access_token\": \"<string>\",\n    \"account_number\": \"9876543210\",\n    \"routing_number\": \"021000021\",\n    \"account_name\": \"John Doe\",\n    \"account_type\": \"checking\"\n  },\n  \"actions\": {}\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.grailpay.com/api/v3/merchants/{uuid}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"client_reference_id\": \"reference_12345\",\n  \"billing_merchant_uuid\": \"6a8fc154-1a50-483b-a690-fd1dfaf9408b\",\n  \"billing_processor_mid\": \"12345678\",\n  \"payout_type\": \"batch\",\n  \"beneficial_owners\": [\n    {\n      \"first_name\": \"Jane\",\n      \"last_name\": \"Doe\",\n      \"dob\": \"2023-04-11\",\n      \"ssn9\": \"123456789\",\n      \"address\": {\n        \"line_1\": \"10554 W Quarles Ave\",\n        \"city\": \"Littleton\",\n        \"state\": \"CO\",\n        \"zip\": \"80127\",\n        \"line_2\": \"Suite 123\"\n      },\n      \"is_beneficial_owner\": true,\n      \"is_director\": false,\n      \"is_significant_control_person\": false,\n      \"ownership_percentage\": 25,\n      \"email\": \"owner@test.com\",\n      \"phone\": \"2457856490\",\n      \"occupation\": \"Co-founder\"\n    }\n  ],\n  \"bank_account\": {\n    \"plaid_account_id\": \"<string>\",\n    \"plaid_access_token\": \"<string>\",\n    \"account_number\": \"9876543210\",\n    \"routing_number\": \"021000021\",\n    \"account_name\": \"John Doe\",\n    \"account_type\": \"checking\"\n  },\n  \"actions\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.grailpay.com/api/v3/merchants/{uuid}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"client_reference_id\": \"reference_12345\",\n  \"billing_merchant_uuid\": \"6a8fc154-1a50-483b-a690-fd1dfaf9408b\",\n  \"billing_processor_mid\": \"12345678\",\n  \"payout_type\": \"batch\",\n  \"beneficial_owners\": [\n    {\n      \"first_name\": \"Jane\",\n      \"last_name\": \"Doe\",\n      \"dob\": \"2023-04-11\",\n      \"ssn9\": \"123456789\",\n      \"address\": {\n        \"line_1\": \"10554 W Quarles Ave\",\n        \"city\": \"Littleton\",\n        \"state\": \"CO\",\n        \"zip\": \"80127\",\n        \"line_2\": \"Suite 123\"\n      },\n      \"is_beneficial_owner\": true,\n      \"is_director\": false,\n      \"is_significant_control_person\": false,\n      \"ownership_percentage\": 25,\n      \"email\": \"owner@test.com\",\n      \"phone\": \"2457856490\",\n      \"occupation\": \"Co-founder\"\n    }\n  ],\n  \"bank_account\": {\n    \"plaid_account_id\": \"<string>\",\n    \"plaid_access_token\": \"<string>\",\n    \"account_number\": \"9876543210\",\n    \"routing_number\": \"021000021\",\n    \"account_name\": \"John Doe\",\n    \"account_type\": \"checking\"\n  },\n  \"actions\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "status": true,
  "message": "This merchant was updated successfully.",
  "data": {
    "merchant": {
      "uuid": "c6bcfbbb-98ff-4d8b-a8f5-1559c3dcb718",
      "business_type": "merchant",
      "kyb_status": "IN_REVIEW",
      "kyb_rejected_reason": null,
      "name": "Acme Inc.",
      "tin": "123456789",
      "trading_name": "Acme Corp",
      "entity_type": "Sole Trader",
      "incorporation_date": "2024-02-02",
      "incorporation_state": "CO",
      "address_type": "Registered",
      "address": {
        "line_1": "10554 W Quarles Ave",
        "line_2": "Suite 123",
        "city": "Littleton",
        "state": "CO",
        "zip": "80127"
      },
      "transaction_fee_percent": 2.5,
      "transaction_fee_fixed": 100,
      "maximum_transaction_fee": 5000,
      "payout_type": "batch",
      "client_reference_id": "reference_12345",
      "timestamps": {
        "created_at": "2024-06-25 13:57:03"
      }
    },
    "beneficial_owners": [
      {
        "first_name": "Jane",
        "last_name": "Doe",
        "dob": "2023-04-11",
        "ssn9": "123456789",
        "address": {
          "line_1": "10554 W Quarles Ave",
          "line_2": "Suite 123",
          "city": "Littleton",
          "state": "CO",
          "zip": "80127"
        },
        "is_beneficial_owner": true,
        "is_director": false,
        "is_significant_control_person": false,
        "ownership_percentage": 25,
        "email": "owner@test.com",
        "phone": "2457856490",
        "occupation": "Co-founder",
        "timestamps": {
          "created_at": "2024-06-25 13:57:03"
        }
      }
    ],
    "relations": {
      "person": {
        "uuid": "7c41f6a2-a4b9-4df8-9225-2c1b7312042e"
      }
    },
    "account_intelligence": {
      "confidence_score": 0.81,
      "decisioning_insights": {
        "account_duplicate": false,
        "days_since_first_seen": -1,
        "days_since_last_transaction": -1,
        "has_negative_transactions": false,
        "has_paid_transactions": false,
        "has_positive_transactions": true,
        "name_match": "yes",
        "phone_number_present": false,
        "valid_routing_number": true
      },
      "version": "v3"
    }
  },
  "errors": null,
  "request_id": "2d6a4c39-8fcf-4d80-9189-b4764eac31f2"
}

{
  "status": false,
  "message": "Invalid Parameters Received",
  "data": null,
  "errors": null,
  "request_id": "2d6a4c39-8fcf-4d80-9189-b4764eac31f2"
}

{
  "status": false,
  "message": "Invalid token.",
  "data": null,
  "errors": null,
  "request_id": "2d6a4c39-8fcf-4d80-9189-b4764eac31f2"
}

{
  "status": false,
  "message": "This merchant is not available as they have been scheduled for deletion.",
  "data": null,
  "errors": null,
  "request_id": "2d6a4c39-8fcf-4d80-9189-b4764eac31f2"
}

{
  "status": false,
  "message": "A merchant matching this UUID was not found.",
  "data": null,
  "errors": null,
  "request_id": "2d6a4c39-8fcf-4d80-9189-b4764eac31f2"
}

{
  "status": false,
  "message": "The request cannot be executed due to a detected conflict with a duplicate request.",
  "data": null,
  "errors": null,
  "request_id": "2d6a4c39-8fcf-4d80-9189-b4764eac31f2"
}

{
  "status": false,
  "message": "The given data was invalid.",
  "data": null,
  "errors": {
    "client_reference_id": [
      "The client reference ID must be a string.",
      "The client reference ID may not be greater than 255 characters."
    ],
    "billing_merchant_uuid": [
      "The billing merchant UUID must be a valid UUID.",
      "The billing merchant UUID does not exist.",
      "The billing merchant UUID is deleted and cannot be used for billing purposes."
    ],
    "billing_processor_mid": [
      "The billing processor MID must be a string.",
      "The billing processor MID does not exist.",
      "The billing processor MID is deleted and cannot be used for billing purposes."
    ],
    "payout_type": [
      "The payout type must be a string.",
      "The payout type must be one of the followings: individual, batch"
    ],
    "bank_account": [
      "You cannot provide both plaid details and manual bank account fields.",
      "This person did not meet the confidence score threshold of 0.5 and has been rejected.",
      "Invalid plaid account ID or access token.",
      "The bank routing number is not valid."
    ],
    "bank_account.plaid_account_id": [
      "The plaid account ID is required when plaid account details is present.",
      "The plaid account ID must be a string."
    ],
    "bank_account.plaid_access_token": [
      "The plaid access token is required when plaid account details is present.",
      "The plaid access token must be a string."
    ],
    "bank_account.account_number": [
      "The bank account number is required when any manual bank account field is provided.",
      "The bank account number must be a string.",
      "The bank account number may not be greater than 17 characters."
    ],
    "bank_account.routing_number": [
      "The bank routing number is required when any manual bank account field is provided.",
      "The bank routing number must be 9 digits."
    ],
    "bank_account.account_name": [
      "The bank account name is required when any manual bank account field is provided.",
      "The bank account name must be a string.",
      "The bank account name may not be greater than 255 characters."
    ],
    "bank_account.account_type": [
      "The bank account type is required when any manual bank account field is provided.",
      "The bank account type must be one of the followings: savings, checking"
    ],
    "actions.account_intelligence": [
      "The person first and last name are required when name match is true.",
      "Name Match is only available when using Account Intelligence Version 3. Please update your request and try again."
    ],
    "actions.account_intelligence.version": [
      "The version is required when account intelligence is present.",
      "The version must be a string.",
      "The version must be one of the followings: v1, v2, v3"
    ],
    "actions.account_intelligence.name_match": [
      "The name match field must be true or false."
    ],
    "person.first_name": [
      "The first name must be a string.",
      "The first name may not be greater than 56 characters."
    ],
    "person.last_name": [
      "The last name must be a string.",
      "The last name may not be greater than 56 characters."
    ],
    "person.email": [
      "The email must be a valid email address."
    ],
    "person.phone": [
      "The phone must be a string.",
      "Phone numbers should consist of 10 digits and should not contain the +1 prefix or any special characters."
    ],
    "person.address.line_1": [
      "The address line 1 is required when address is present.",
      "The address line 1 must be a string.",
      "The address line 1 may not be greater than 255 characters."
    ],
    "person.address.line_2": [
      "The address line 2 must be a string.",
      "The address line 2 may not be greater than 255 characters."
    ],
    "person.address.city": [
      "The city name is required when address is present.",
      "The city name must be a string.",
      "The city name may not be greater than 56 characters.",
      "The city name field only accepts letters (a-z, A-Z), numbers (0-9), hyphens (-), periods (.), apostrophes ('), and spaces."
    ],
    "person.address.state": [
      "The state is required when address is present.",
      "The state must be a string.",
      "The state may not be greater than 2 characters.",
      "The state must be valid US state."
    ],
    "person.address.zip": [
      "The zip code is required when address is present.",
      "The zip code must be a string.",
      "The zip code must consist of 5 digit."
    ],
    "business.name": [
      "The name must be a string.",
      "The name may not be greater than 255 characters."
    ],
    "business.trading_name": [
      "The trading name must be a string.",
      "The trading name may not be greater than 255 characters."
    ],
    "business.address.line_1": [
      "The address line 1 is required when address is present.",
      "The address line 1 must be a string.",
      "The address line 1 may not be greater than 255 characters."
    ],
    "business.address.line_2": [
      "The address line 2 must be a string.",
      "The address line 2 may not be greater than 255 characters."
    ],
    "business.address.city": [
      "The city name is required when address is present.",
      "The city name must be a string.",
      "The city name may not be greater than 56 characters.",
      "The city name field only accepts letters (a-z, A-Z), numbers (0-9), hyphens (-), periods (.), apostrophes ('), and spaces."
    ],
    "business.address.state": [
      "The state is required when address is present.",
      "The state must be a string.",
      "The state may not be greater than 2 characters.",
      "The state must be valid US state."
    ],
    "business.address.zip": [
      "The zip code is required when address is present.",
      "The zip code must be a string.",
      "The zip code must consist of 5 digit."
    ]
  },
  "request_id": "2d6a4c39-8fcf-4d80-9189-b4764eac31f2"
}

{
  "status": false,
  "message": "There was a problem on the server and the action could not be completed. Please try again.",
  "data": null,
  "errors": null,
  "request_id": "2d6a4c39-8fcf-4d80-9189-b4764eac31f2"
}