Update bill payment

curl --request POST \
  --url https://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_id": "<string>",
  "vendor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "vendor_external_id": "<string>",
  "at": "2023-11-07T05:31:56Z",
  "amount": 123,
  "method": "ACH",
  "processor": "<string>",
  "payment_clearing_account_identifier": {
    "type": "AccountId",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "bill_payment_allocations": [
    {
      "amount": 123,
      "bill_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "bill_external_id": "<string>",
      "tags": [
        {
          "key": "department",
          "value": "sales",
          "dimension_display_name": "Department",
          "value_display_name": "Sales Department"
        }
      ],
      "memo": "<string>",
      "metadata": {
        "custom_field": "value",
        "any valid json": "below 1kb",
        "nested": {
          "meaning of life": 42,
          "array": []
        }
      },
      "reference_number": "<string>"
    }
  ],
  "tags": [
    {
      "key": "department",
      "value": "sales",
      "dimension_display_name": "Department",
      "value_display_name": "Sales Department"
    }
  ],
  "memo": "<string>",
  "metadata": {
    "custom_field": "value",
    "any valid json": "below 1kb",
    "nested": {
      "meaning of life": 42,
      "array": []
    }
  },
  "reference_number": "<string>"
}
'

import requests

url = "https://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update"

payload = {
    "external_id": "<string>",
    "vendor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "vendor_external_id": "<string>",
    "at": "2023-11-07T05:31:56Z",
    "amount": 123,
    "method": "ACH",
    "processor": "<string>",
    "payment_clearing_account_identifier": {
        "type": "AccountId",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "bill_payment_allocations": [
        {
            "amount": 123,
            "bill_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "bill_external_id": "<string>",
            "tags": [
                {
                    "key": "department",
                    "value": "sales",
                    "dimension_display_name": "Department",
                    "value_display_name": "Sales Department"
                }
            ],
            "memo": "<string>",
            "metadata": {
                "custom_field": "value",
                "any valid json": "below 1kb",
                "nested": {
                    "meaning of life": 42,
                    "array": []
                }
            },
            "reference_number": "<string>"
        }
    ],
    "tags": [
        {
            "key": "department",
            "value": "sales",
            "dimension_display_name": "Department",
            "value_display_name": "Sales Department"
        }
    ],
    "memo": "<string>",
    "metadata": {
        "custom_field": "value",
        "any valid json": "below 1kb",
        "nested": {
            "meaning of life": 42,
            "array": []
        }
    },
    "reference_number": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    external_id: '<string>',
    vendor_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    vendor_external_id: '<string>',
    at: '2023-11-07T05:31:56Z',
    amount: 123,
    method: 'ACH',
    processor: '<string>',
    payment_clearing_account_identifier: {type: 'AccountId', id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'},
    bill_payment_allocations: [
      {
        amount: 123,
        bill_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        bill_external_id: '<string>',
        tags: [
          {
            key: 'department',
            value: 'sales',
            dimension_display_name: 'Department',
            value_display_name: 'Sales Department'
          }
        ],
        memo: '<string>',
        metadata: {
          custom_field: 'value',
          'any valid json': 'below 1kb',
          nested: {'meaning of life': 42, array: []}
        },
        reference_number: '<string>'
      }
    ],
    tags: [
      {
        key: 'department',
        value: 'sales',
        dimension_display_name: 'Department',
        value_display_name: 'Sales Department'
      }
    ],
    memo: '<string>',
    metadata: {
      custom_field: 'value',
      'any valid json': 'below 1kb',
      nested: {'meaning of life': 42, array: []}
    },
    reference_number: '<string>'
  })
};

fetch('https://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update', 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://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'external_id' => '<string>',
    'vendor_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'vendor_external_id' => '<string>',
    'at' => '2023-11-07T05:31:56Z',
    'amount' => 123,
    'method' => 'ACH',
    'processor' => '<string>',
    'payment_clearing_account_identifier' => [
        'type' => 'AccountId',
        'id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'bill_payment_allocations' => [
        [
                'amount' => 123,
                'bill_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                'bill_external_id' => '<string>',
                'tags' => [
                                [
                                                                'key' => 'department',
                                                                'value' => 'sales',
                                                                'dimension_display_name' => 'Department',
                                                                'value_display_name' => 'Sales Department'
                                ]
                ],
                'memo' => '<string>',
                'metadata' => [
                                'custom_field' => 'value',
                                'any valid json' => 'below 1kb',
                                'nested' => [
                                                                'meaning of life' => 42,
                                                                'array' => [
                                                                                                                                
                                                                ]
                                ]
                ],
                'reference_number' => '<string>'
        ]
    ],
    'tags' => [
        [
                'key' => 'department',
                'value' => 'sales',
                'dimension_display_name' => 'Department',
                'value_display_name' => 'Sales Department'
        ]
    ],
    'memo' => '<string>',
    'metadata' => [
        'custom_field' => 'value',
        'any valid json' => 'below 1kb',
        'nested' => [
                'meaning of life' => 42,
                'array' => [
                                
                ]
        ]
    ],
    'reference_number' => '<string>'
  ]),
  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://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update"

	payload := strings.NewReader("{\n  \"external_id\": \"<string>\",\n  \"vendor_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"vendor_external_id\": \"<string>\",\n  \"at\": \"2023-11-07T05:31:56Z\",\n  \"amount\": 123,\n  \"method\": \"ACH\",\n  \"processor\": \"<string>\",\n  \"payment_clearing_account_identifier\": {\n    \"type\": \"AccountId\",\n    \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  },\n  \"bill_payment_allocations\": [\n    {\n      \"amount\": 123,\n      \"bill_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"bill_external_id\": \"<string>\",\n      \"tags\": [\n        {\n          \"key\": \"department\",\n          \"value\": \"sales\",\n          \"dimension_display_name\": \"Department\",\n          \"value_display_name\": \"Sales Department\"\n        }\n      ],\n      \"memo\": \"<string>\",\n      \"metadata\": {\n        \"custom_field\": \"value\",\n        \"any valid json\": \"below 1kb\",\n        \"nested\": {\n          \"meaning of life\": 42,\n          \"array\": []\n        }\n      },\n      \"reference_number\": \"<string>\"\n    }\n  ],\n  \"tags\": [\n    {\n      \"key\": \"department\",\n      \"value\": \"sales\",\n      \"dimension_display_name\": \"Department\",\n      \"value_display_name\": \"Sales Department\"\n    }\n  ],\n  \"memo\": \"<string>\",\n  \"metadata\": {\n    \"custom_field\": \"value\",\n    \"any valid json\": \"below 1kb\",\n    \"nested\": {\n      \"meaning of life\": 42,\n      \"array\": []\n    }\n  },\n  \"reference_number\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", 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.post("https://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"external_id\": \"<string>\",\n  \"vendor_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"vendor_external_id\": \"<string>\",\n  \"at\": \"2023-11-07T05:31:56Z\",\n  \"amount\": 123,\n  \"method\": \"ACH\",\n  \"processor\": \"<string>\",\n  \"payment_clearing_account_identifier\": {\n    \"type\": \"AccountId\",\n    \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  },\n  \"bill_payment_allocations\": [\n    {\n      \"amount\": 123,\n      \"bill_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"bill_external_id\": \"<string>\",\n      \"tags\": [\n        {\n          \"key\": \"department\",\n          \"value\": \"sales\",\n          \"dimension_display_name\": \"Department\",\n          \"value_display_name\": \"Sales Department\"\n        }\n      ],\n      \"memo\": \"<string>\",\n      \"metadata\": {\n        \"custom_field\": \"value\",\n        \"any valid json\": \"below 1kb\",\n        \"nested\": {\n          \"meaning of life\": 42,\n          \"array\": []\n        }\n      },\n      \"reference_number\": \"<string>\"\n    }\n  ],\n  \"tags\": [\n    {\n      \"key\": \"department\",\n      \"value\": \"sales\",\n      \"dimension_display_name\": \"Department\",\n      \"value_display_name\": \"Sales Department\"\n    }\n  ],\n  \"memo\": \"<string>\",\n  \"metadata\": {\n    \"custom_field\": \"value\",\n    \"any valid json\": \"below 1kb\",\n    \"nested\": {\n      \"meaning of life\": 42,\n      \"array\": []\n    }\n  },\n  \"reference_number\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"external_id\": \"<string>\",\n  \"vendor_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"vendor_external_id\": \"<string>\",\n  \"at\": \"2023-11-07T05:31:56Z\",\n  \"amount\": 123,\n  \"method\": \"ACH\",\n  \"processor\": \"<string>\",\n  \"payment_clearing_account_identifier\": {\n    \"type\": \"AccountId\",\n    \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  },\n  \"bill_payment_allocations\": [\n    {\n      \"amount\": 123,\n      \"bill_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"bill_external_id\": \"<string>\",\n      \"tags\": [\n        {\n          \"key\": \"department\",\n          \"value\": \"sales\",\n          \"dimension_display_name\": \"Department\",\n          \"value_display_name\": \"Sales Department\"\n        }\n      ],\n      \"memo\": \"<string>\",\n      \"metadata\": {\n        \"custom_field\": \"value\",\n        \"any valid json\": \"below 1kb\",\n        \"nested\": {\n          \"meaning of life\": 42,\n          \"array\": []\n        }\n      },\n      \"reference_number\": \"<string>\"\n    }\n  ],\n  \"tags\": [\n    {\n      \"key\": \"department\",\n      \"value\": \"sales\",\n      \"dimension_display_name\": \"Department\",\n      \"value_display_name\": \"Sales Department\"\n    }\n  ],\n  \"memo\": \"<string>\",\n  \"metadata\": {\n    \"custom_field\": \"value\",\n    \"any valid json\": \"below 1kb\",\n    \"nested\": {\n      \"meaning of life\": 42,\n      \"array\": []\n    }\n  },\n  \"reference_number\": \"<string>\"\n}"

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

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "external_id": "<string>",
    "vendor": {
      "type": "VendorData",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "external_id": "<string>",
      "individual_name": "<string>",
      "company_name": "<string>",
      "email": "<string>",
      "mobile_phone": "<string>",
      "office_phone": "<string>",
      "address_string": "<string>",
      "memo": "<string>",
      "status": "ACTIVE",
      "transaction_tags": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "key": "ExampleTagKey",
          "value": "ExampleTagValue",
          "dimension_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "definition_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "dimension_display_name": "<string>",
          "value_display_name": "<string>",
          "archived_at": "2023-11-07T05:31:56Z"
        }
      ]
    },
    "at": "2023-11-07T05:31:56Z",
    "method": "ACH",
    "amount": 123,
    "processor": "<string>",
    "payment_clearing_account": {
      "type": "Single_Chart_Account",
      "id": {
        "type": "AccountId",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "name": "Current Assets",
      "account_number": "4000",
      "stable_name": {
        "type": "StableName",
        "stable_name": "CURRENT_ASSETS"
      },
      "normality": "DEBIT",
      "account_type": {
        "value": "ASSET",
        "display_name": "Asset"
      },
      "account_subtype": {
        "value": "BANK_ACCOUNTS",
        "display_name": "Current Assets"
      }
    },
    "imported_at": "2023-11-07T05:31:56Z",
    "allocations": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "bill_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "payment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "amount": 123,
        "transaction_tags": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "key": "ExampleTagKey",
            "value": "ExampleTagValue",
            "dimension_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "definition_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "dimension_display_name": "<string>",
            "value_display_name": "<string>",
            "archived_at": "2023-11-07T05:31:56Z"
          }
        ],
        "memo": "<string>",
        "metadata": {
          "custom_field": "value",
          "any valid json": "below 1kb",
          "nested": {
            "meaning of life": 42,
            "array": []
          }
        },
        "reference_number": "<string>"
      }
    ],
    "transaction_tags": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "key": "ExampleTagKey",
        "value": "ExampleTagValue",
        "dimension_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "definition_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dimension_display_name": "<string>",
        "value_display_name": "<string>",
        "archived_at": "2023-11-07T05:31:56Z"
      }
    ],
    "memo": "<string>",
    "metadata": {
      "custom_field": "value",
      "any valid json": "below 1kb",
      "nested": {
        "meaning of life": 42,
        "array": []
      }
    },
    "reference_number": "<string>"
  }
}

{
  "type": "InvalidParameters",
  "description": "<string>",
  "error_enum": "InvalidPayload",
  "meta": {}
}

POST

businesses

{businessId}

bills

bill-payments

{paymentId}

update

Update bill payment

curl --request POST \
  --url https://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_id": "<string>",
  "vendor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "vendor_external_id": "<string>",
  "at": "2023-11-07T05:31:56Z",
  "amount": 123,
  "method": "ACH",
  "processor": "<string>",
  "payment_clearing_account_identifier": {
    "type": "AccountId",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "bill_payment_allocations": [
    {
      "amount": 123,
      "bill_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "bill_external_id": "<string>",
      "tags": [
        {
          "key": "department",
          "value": "sales",
          "dimension_display_name": "Department",
          "value_display_name": "Sales Department"
        }
      ],
      "memo": "<string>",
      "metadata": {
        "custom_field": "value",
        "any valid json": "below 1kb",
        "nested": {
          "meaning of life": 42,
          "array": []
        }
      },
      "reference_number": "<string>"
    }
  ],
  "tags": [
    {
      "key": "department",
      "value": "sales",
      "dimension_display_name": "Department",
      "value_display_name": "Sales Department"
    }
  ],
  "memo": "<string>",
  "metadata": {
    "custom_field": "value",
    "any valid json": "below 1kb",
    "nested": {
      "meaning of life": 42,
      "array": []
    }
  },
  "reference_number": "<string>"
}
'

import requests

url = "https://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update"

payload = {
    "external_id": "<string>",
    "vendor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "vendor_external_id": "<string>",
    "at": "2023-11-07T05:31:56Z",
    "amount": 123,
    "method": "ACH",
    "processor": "<string>",
    "payment_clearing_account_identifier": {
        "type": "AccountId",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "bill_payment_allocations": [
        {
            "amount": 123,
            "bill_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "bill_external_id": "<string>",
            "tags": [
                {
                    "key": "department",
                    "value": "sales",
                    "dimension_display_name": "Department",
                    "value_display_name": "Sales Department"
                }
            ],
            "memo": "<string>",
            "metadata": {
                "custom_field": "value",
                "any valid json": "below 1kb",
                "nested": {
                    "meaning of life": 42,
                    "array": []
                }
            },
            "reference_number": "<string>"
        }
    ],
    "tags": [
        {
            "key": "department",
            "value": "sales",
            "dimension_display_name": "Department",
            "value_display_name": "Sales Department"
        }
    ],
    "memo": "<string>",
    "metadata": {
        "custom_field": "value",
        "any valid json": "below 1kb",
        "nested": {
            "meaning of life": 42,
            "array": []
        }
    },
    "reference_number": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    external_id: '<string>',
    vendor_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    vendor_external_id: '<string>',
    at: '2023-11-07T05:31:56Z',
    amount: 123,
    method: 'ACH',
    processor: '<string>',
    payment_clearing_account_identifier: {type: 'AccountId', id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'},
    bill_payment_allocations: [
      {
        amount: 123,
        bill_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        bill_external_id: '<string>',
        tags: [
          {
            key: 'department',
            value: 'sales',
            dimension_display_name: 'Department',
            value_display_name: 'Sales Department'
          }
        ],
        memo: '<string>',
        metadata: {
          custom_field: 'value',
          'any valid json': 'below 1kb',
          nested: {'meaning of life': 42, array: []}
        },
        reference_number: '<string>'
      }
    ],
    tags: [
      {
        key: 'department',
        value: 'sales',
        dimension_display_name: 'Department',
        value_display_name: 'Sales Department'
      }
    ],
    memo: '<string>',
    metadata: {
      custom_field: 'value',
      'any valid json': 'below 1kb',
      nested: {'meaning of life': 42, array: []}
    },
    reference_number: '<string>'
  })
};

fetch('https://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update', 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://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'external_id' => '<string>',
    'vendor_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'vendor_external_id' => '<string>',
    'at' => '2023-11-07T05:31:56Z',
    'amount' => 123,
    'method' => 'ACH',
    'processor' => '<string>',
    'payment_clearing_account_identifier' => [
        'type' => 'AccountId',
        'id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'bill_payment_allocations' => [
        [
                'amount' => 123,
                'bill_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                'bill_external_id' => '<string>',
                'tags' => [
                                [
                                                                'key' => 'department',
                                                                'value' => 'sales',
                                                                'dimension_display_name' => 'Department',
                                                                'value_display_name' => 'Sales Department'
                                ]
                ],
                'memo' => '<string>',
                'metadata' => [
                                'custom_field' => 'value',
                                'any valid json' => 'below 1kb',
                                'nested' => [
                                                                'meaning of life' => 42,
                                                                'array' => [
                                                                                                                                
                                                                ]
                                ]
                ],
                'reference_number' => '<string>'
        ]
    ],
    'tags' => [
        [
                'key' => 'department',
                'value' => 'sales',
                'dimension_display_name' => 'Department',
                'value_display_name' => 'Sales Department'
        ]
    ],
    'memo' => '<string>',
    'metadata' => [
        'custom_field' => 'value',
        'any valid json' => 'below 1kb',
        'nested' => [
                'meaning of life' => 42,
                'array' => [
                                
                ]
        ]
    ],
    'reference_number' => '<string>'
  ]),
  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://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update"

	payload := strings.NewReader("{\n  \"external_id\": \"<string>\",\n  \"vendor_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"vendor_external_id\": \"<string>\",\n  \"at\": \"2023-11-07T05:31:56Z\",\n  \"amount\": 123,\n  \"method\": \"ACH\",\n  \"processor\": \"<string>\",\n  \"payment_clearing_account_identifier\": {\n    \"type\": \"AccountId\",\n    \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  },\n  \"bill_payment_allocations\": [\n    {\n      \"amount\": 123,\n      \"bill_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"bill_external_id\": \"<string>\",\n      \"tags\": [\n        {\n          \"key\": \"department\",\n          \"value\": \"sales\",\n          \"dimension_display_name\": \"Department\",\n          \"value_display_name\": \"Sales Department\"\n        }\n      ],\n      \"memo\": \"<string>\",\n      \"metadata\": {\n        \"custom_field\": \"value\",\n        \"any valid json\": \"below 1kb\",\n        \"nested\": {\n          \"meaning of life\": 42,\n          \"array\": []\n        }\n      },\n      \"reference_number\": \"<string>\"\n    }\n  ],\n  \"tags\": [\n    {\n      \"key\": \"department\",\n      \"value\": \"sales\",\n      \"dimension_display_name\": \"Department\",\n      \"value_display_name\": \"Sales Department\"\n    }\n  ],\n  \"memo\": \"<string>\",\n  \"metadata\": {\n    \"custom_field\": \"value\",\n    \"any valid json\": \"below 1kb\",\n    \"nested\": {\n      \"meaning of life\": 42,\n      \"array\": []\n    }\n  },\n  \"reference_number\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", 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.post("https://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"external_id\": \"<string>\",\n  \"vendor_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"vendor_external_id\": \"<string>\",\n  \"at\": \"2023-11-07T05:31:56Z\",\n  \"amount\": 123,\n  \"method\": \"ACH\",\n  \"processor\": \"<string>\",\n  \"payment_clearing_account_identifier\": {\n    \"type\": \"AccountId\",\n    \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  },\n  \"bill_payment_allocations\": [\n    {\n      \"amount\": 123,\n      \"bill_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"bill_external_id\": \"<string>\",\n      \"tags\": [\n        {\n          \"key\": \"department\",\n          \"value\": \"sales\",\n          \"dimension_display_name\": \"Department\",\n          \"value_display_name\": \"Sales Department\"\n        }\n      ],\n      \"memo\": \"<string>\",\n      \"metadata\": {\n        \"custom_field\": \"value\",\n        \"any valid json\": \"below 1kb\",\n        \"nested\": {\n          \"meaning of life\": 42,\n          \"array\": []\n        }\n      },\n      \"reference_number\": \"<string>\"\n    }\n  ],\n  \"tags\": [\n    {\n      \"key\": \"department\",\n      \"value\": \"sales\",\n      \"dimension_display_name\": \"Department\",\n      \"value_display_name\": \"Sales Department\"\n    }\n  ],\n  \"memo\": \"<string>\",\n  \"metadata\": {\n    \"custom_field\": \"value\",\n    \"any valid json\": \"below 1kb\",\n    \"nested\": {\n      \"meaning of life\": 42,\n      \"array\": []\n    }\n  },\n  \"reference_number\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox.layerfi.com/v1/businesses/{businessId}/bills/bill-payments/{paymentId}/update")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"external_id\": \"<string>\",\n  \"vendor_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"vendor_external_id\": \"<string>\",\n  \"at\": \"2023-11-07T05:31:56Z\",\n  \"amount\": 123,\n  \"method\": \"ACH\",\n  \"processor\": \"<string>\",\n  \"payment_clearing_account_identifier\": {\n    \"type\": \"AccountId\",\n    \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  },\n  \"bill_payment_allocations\": [\n    {\n      \"amount\": 123,\n      \"bill_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"bill_external_id\": \"<string>\",\n      \"tags\": [\n        {\n          \"key\": \"department\",\n          \"value\": \"sales\",\n          \"dimension_display_name\": \"Department\",\n          \"value_display_name\": \"Sales Department\"\n        }\n      ],\n      \"memo\": \"<string>\",\n      \"metadata\": {\n        \"custom_field\": \"value\",\n        \"any valid json\": \"below 1kb\",\n        \"nested\": {\n          \"meaning of life\": 42,\n          \"array\": []\n        }\n      },\n      \"reference_number\": \"<string>\"\n    }\n  ],\n  \"tags\": [\n    {\n      \"key\": \"department\",\n      \"value\": \"sales\",\n      \"dimension_display_name\": \"Department\",\n      \"value_display_name\": \"Sales Department\"\n    }\n  ],\n  \"memo\": \"<string>\",\n  \"metadata\": {\n    \"custom_field\": \"value\",\n    \"any valid json\": \"below 1kb\",\n    \"nested\": {\n      \"meaning of life\": 42,\n      \"array\": []\n    }\n  },\n  \"reference_number\": \"<string>\"\n}"

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

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "external_id": "<string>",
    "vendor": {
      "type": "VendorData",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "external_id": "<string>",
      "individual_name": "<string>",
      "company_name": "<string>",
      "email": "<string>",
      "mobile_phone": "<string>",
      "office_phone": "<string>",
      "address_string": "<string>",
      "memo": "<string>",
      "status": "ACTIVE",
      "transaction_tags": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "key": "ExampleTagKey",
          "value": "ExampleTagValue",
          "dimension_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "definition_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "dimension_display_name": "<string>",
          "value_display_name": "<string>",
          "archived_at": "2023-11-07T05:31:56Z"
        }
      ]
    },
    "at": "2023-11-07T05:31:56Z",
    "method": "ACH",
    "amount": 123,
    "processor": "<string>",
    "payment_clearing_account": {
      "type": "Single_Chart_Account",
      "id": {
        "type": "AccountId",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "name": "Current Assets",
      "account_number": "4000",
      "stable_name": {
        "type": "StableName",
        "stable_name": "CURRENT_ASSETS"
      },
      "normality": "DEBIT",
      "account_type": {
        "value": "ASSET",
        "display_name": "Asset"
      },
      "account_subtype": {
        "value": "BANK_ACCOUNTS",
        "display_name": "Current Assets"
      }
    },
    "imported_at": "2023-11-07T05:31:56Z",
    "allocations": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "bill_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "payment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "amount": 123,
        "transaction_tags": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "key": "ExampleTagKey",
            "value": "ExampleTagValue",
            "dimension_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "definition_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "dimension_display_name": "<string>",
            "value_display_name": "<string>",
            "archived_at": "2023-11-07T05:31:56Z"
          }
        ],
        "memo": "<string>",
        "metadata": {
          "custom_field": "value",
          "any valid json": "below 1kb",
          "nested": {
            "meaning of life": 42,
            "array": []
          }
        },
        "reference_number": "<string>"
      }
    ],
    "transaction_tags": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "key": "ExampleTagKey",
        "value": "ExampleTagValue",
        "dimension_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "definition_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dimension_display_name": "<string>",
        "value_display_name": "<string>",
        "archived_at": "2023-11-07T05:31:56Z"
      }
    ],
    "memo": "<string>",
    "metadata": {
      "custom_field": "value",
      "any valid json": "below 1kb",
      "nested": {
        "meaning of life": 42,
        "array": []
      }
    },
    "reference_number": "<string>"
  }
}

{
  "type": "InvalidParameters",
  "description": "<string>",
  "error_enum": "InvalidPayload",
  "meta": {}
}

Authorizations

Authorization

string

header

required

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

Path Parameters

businessId

string<uuid>

required

The UUID of the business the payment belongs to.

paymentId

string<uuid>

required

The UUID of the payment to update.

Body

application/json

external_id

string | null

External ID for the payment.

vendor_id

string<uuid> | null

Layer ID of the vendor to associate with the payment. Pass null to clear the association. When the payment has bill allocations, the vendor must match the vendor on every allocated bill, otherwise the request is rejected with a 400.

vendor_external_id

string | null

External ID of the vendor to associate with the payment. Can be specified in place of vendor_id.

string<date-time>

When the payment was made.

amount

integer<int64>

Payment amount in cents.

method

enum<string>

Method used for payment.

Available options:

CASH,

CHECK,

CREDIT_CARD,

ACH,

CREDIT_BALANCE,

OTHER

Example:

"ACH"

processor

string | null

Payment processor used.

payment_clearing_account_identifier

Account ID · object

The the ledger account to use for the payment (overrides the default determined by the payment method).

Account ID
Account Stable Name

Show child attributes

bill_payment_allocations

object[]

Updated payment allocations across bills.

Show child attributes

Response

Payment updated successfully.

data

object

required

Show child attributes

Businesses

Financial Activity

Accounting Reports

Platform Configuration

Platform reporting

Integrations

Update bill payment

Authorizations

Path Parameters

Body

Response