Making Payments

πŸŽ‰ At this point, you have a vendor with associated payment information created in Routable!

Paying them is pretty simple too using our Create an Item operation.

πŸ“˜

I don't have time to read that JSON request...

The most important fields to be aware of in these examples are...

  • payment_delivery_option which we've used to specify how we will be paying our vendor (e.g. ACH)
  • relationships.partner_receivable_account which specifies which account we will be paying our vendor to (e.g. their checking account)
// POST /items/ HTTP/1.1
// Accept: application/vnd.api+json
// Content-Type: application/vnd.api+json

{
  "data":{
    "attributes":{
      "amount":5000,
      "kind":"payable",
      "payment_delivery_option":"ach_standard",
      "reference":"Invoice #4245"
    },
    "relationships":{
      "funding_account":{
        "data":{
          "id":"01c4039a-644a-4f60-9085-23890208336e",
          "type":"FundingAccount"
        }
      },
      "line_items":{
        "data":[
          {
            "attributes":{
              "amount":5000,
              "description":"Office Space",
              "quantity":1,
              "style":"item",
              "unit_price":5000
            },
            "type":"LineItem"
          }
        ]
      },
      "partner_receivable_account":{
        "data":{
          "id":"4beeb8ca-b969-4c22-86bd-c54638e835e5",
          "type":"FundingAccount"
        }
      },
      "partnership":{
        "data":{
          "id":"a99945e9-815a-4ba7-9e57-cc88972d0222",
          "type":"Partnership"
        }
      },
      "item_members":{
        "data":[
          {
            "attributes":{
              "access_item":"actionable"
            },
            "relationships":{
              "partnership_member":{
                "data":{
                  "id":"082ddd91-5882-48d5-8253-c3e550ae178f",
                  "type":"PartnershipMember"
                }
              }
            },
            "type":"ItemMember"
          }
        ]
      },
      "requester":{
        "data":{
          "id":"451795f6-f54f-4861-ba55-6c22b097a6e4",
          "type":"Membership"
        }
      }
    },
    "type":"Item"
  }
}
{
  "data":{
    "type":"Item",
    "id":"840c78d4-03d7-40a0-8c01-4ecb35d09d62",
    "attributes":{
      "amount":"5000.00",
      "amount_due":"5000.00",
      "amount_paid":"0.00",
      "check_number":null,
      "date_approved":null,
      "date_due":"2021-03-23",
      "date_expected":null,
      "date_externally_paid":null,
      "date_issued":"2021-03-23",
      "date_scheduled":null,
      "date_sent":"2021-03-23",
      "date_status_change":"2021-03-23T23:09:02.186165Z",
      "days_until_due":0,
      "external_ref":null,
      "externally_paid_method":null,
      "externally_paid_reference":null,
      "funding_provider_memo":null,
      "has_attachments":false,
      "invoice_number":null,
      "is_creator":true,
      "kind":"payable",
      "ledger_ref":null,
      "ledger_status":"no_ledger",
      "payment_delivery_method":"ach",
      "payment_delivery_methods_accepted":[
        "ach"
      ],
      "payment_delivery_option":"ach_standard",
      "payment_terms":null,
      "reference":"Invoice #4245",
      "status":"processing",
      "status_timeline":[
        {
          "date":"2021-03-23T23:09:02.186165Z",
          "status":"processing"
        }
      ]
    },
    "relationships":{
      "approvals":{
        "data":[
          
        ]
      },
      "attachments":{
        "meta":{
          "count":0
        },
        "data":[
          
        ]
      },
      "funding_account":{
        "data":{
          "type":"FundingAccount",
          "id":"01c4039a-644a-4f60-9085-23890208336e"
        }
      },
      "item_members":{
        "meta":{
          "count":2
        },
        "data":[
          {
            "type":"ItemMember",
            "id":"9bab7b7b-00a8-448b-b379-9105ca36a8f2"
          },
          {
            "type":"ItemMember",
            "id":"b4dbe479-c888-4ec2-a648-e175041ea1e6"
          }
        ]
      },
      "partner":{
        "data":{
          "type":"Company",
          "id":"5c81ac75-1599-4991-987a-8418d92698f2"
        }
      },
      "partner_funding_account":{
        "data":{
          "type":"FundingAccount",
          "id":"4beeb8ca-b969-4c22-86bd-c54638e835e5"
        }
      },
      "partnership":{
        "data":{
          "type":"Partnership",
          "id":"a99945e9-815a-4ba7-9e57-cc88972d0222"
        }
      },
      "tag_links":{
        "data":[
          
        ]
      }
    }
  },
  "included":[
    {
      "type":"Company",
      "id":"5c81ac75-1599-4991-987a-8418d92698f2",
      "attributes":{
        "name":"InstaWork"
      }
    },
    {
      "type":"FundingAccount",
      "id":"01c4039a-644a-4f60-9085-23890208336e",
      "attributes":{
        
      },
      "relationships":{
        "address":{
          "data":null
        },
        "bank":{
          "data":{
            "type":"FundingInfoBank",
            "id":"539f5941-643d-4db1-a235-31d3c9a512f1"
          }
        },
        "company":{
          "data":{
            "type":"Company",
            "id":"e4163ce1-dc78-47a0-ae6c-68aab52411e8"
          }
        }
      }
    },
    {
      "type":"FundingAccount",
      "id":"4beeb8ca-b969-4c22-86bd-c54638e835e5",
      "attributes":{
        
      },
      "relationships":{
        "address":{
          "data":null
        },
        "bank":{
          "data":{
            "type":"FundingInfoBank",
            "id":"62ab724d-98d6-4b0a-9177-41e1680912fe"
          }
        },
        "company":{
          "data":{
            "type":"Company",
            "id":"5c81ac75-1599-4991-987a-8418d92698f2"
          }
        }
      }
    },
    {
      "type":"FundingInfoBank",
      "id":"539f5941-643d-4db1-a235-31d3c9a512f1",
      "attributes":{
        "account_number":"49604",
        "institution_name":"Wells Fargo Bank Na  (Minnesota)",
        "routing_number":"091000019"
      }
    },
    {
      "type":"FundingInfoBank",
      "id":"62ab724d-98d6-4b0a-9177-41e1680912fe",
      "attributes":{
        "account_number":"***3210",
        "institution_name":"Jpmorgan Chase",
        "routing_number":"021000021"
      }
    },
    {
      "type":"ItemMember",
      "id":"9bab7b7b-00a8-448b-b379-9105ca36a8f2",
      "attributes":{
        "access_item":"self_managed"
      },
      "relationships":{
        "partnership_member":{
          "data":{
            "type":"PartnershipMember",
            "id":"49c49dfc-60c0-42cf-8bd4-8ec6e4f4ea04"
          }
        }
      }
    },
    {
      "type":"ItemMember",
      "id":"b4dbe479-c888-4ec2-a648-e175041ea1e6",
      "attributes":{
        "access_item":"actionable"
      },
      "relationships":{
        "partnership_member":{
          "data":{
            "type":"PartnershipMember",
            "id":"082ddd91-5882-48d5-8253-c3e550ae178f"
          }
        }
      }
    },
    {
      "type":"Partnership",
      "id":"a99945e9-815a-4ba7-9e57-cc88972d0222",
      "attributes":{
        "customer_ref":null,
        "name":"InstaWork",
        "vendor_ref":null
      }
    },
    {
      "type":"PartnershipMember",
      "id":"082ddd91-5882-48d5-8253-c3e550ae178f",
      "attributes":{
        "avatar":null,
        "default_general":"actionable",
        "default_item":"actionable",
        "email":"[email protected]",
        "first_name":"Zaldy",
        "is_archived":false,
        "last_name":"Worker",
        "notification_general":"actionable",
        "phone_number":null
      },
      "relationships":{
        "company":{
          "data":{
            "type":"Company",
            "id":"5c81ac75-1599-4991-987a-8418d92698f2"
          }
        },
        "membership":{
          "data":{
            "type":"Membership",
            "id":"5a1a689f-c4f7-4cbc-b4e4-ff94a8b8d675"
          }
        },
        "notification_bounce":{
          "data":null
        }
      }
    },
    {
      "type":"PartnershipMember",
      "id":"49c49dfc-60c0-42cf-8bd4-8ec6e4f4ea04",
      "attributes":{
        "avatar":null,
        "default_general":"self_managed",
        "default_item":"self_managed",
        "email":"[email protected]",
        "first_name":"Kevin",
        "is_archived":false,
        "last_name":"Malone",
        "notification_general":"self_managed",
        "phone_number":{
          "number":"+11917280016",
          "country":"US"
        }
      },
      "relationships":{
        "company":{
          "data":{
            "type":"Company",
            "id":"e4163ce1-dc78-47a0-ae6c-68aab52411e8"
          }
        },
        "membership":{
          "data":{
            "type":"Membership",
            "id":"451795f6-f54f-4861-ba55-6c22b097a6e4"
          }
        },
        "notification_bounce":{
          "data":null
        }
      }
    }
  ]
}
// POST /items/ HTTP/1.1
// Accept: application/vnd.api+json
// Content-Type: application/vnd.api+json

{
  "data":{
    "attributes":{
      "amount":5000,
      "kind":"payable",
      "payment_delivery_option":"check_standard",
      "reference":"Invoice #4245"
    },
    "relationships":{
      "funding_account":{
        "data":{
          "id":"01c4039a-644a-4f60-9085-23890208336e",
          "type":"FundingAccount"
        }
      },
      "line_items":{
        "data":[
          {
            "attributes":{
              "amount":5000,
              "description":"Office Space",
              "quantity":1,
              "style":"item",
              "unit_price":5000
            },
            "type":"LineItem"
          }
        ]
      },
      "partner_receivable_account":{
        "data":{
          "id":"1148eea4-5134-4b4f-8031-a59cd81a52e2",
          "type":"FundingAccount"
        }
      },
      "partnership":{
        "data":{
          "id":"a99945e9-815a-4ba7-9e57-cc88972d0222",
          "type":"Partnership"
        }
      },
      "item_members":{
        "data":[
          {
            "attributes":{
              "access_item":"actionable"
            },
            "relationships":{
              "partnership_member":{
                "data":{
                  "id":"082ddd91-5882-48d5-8253-c3e550ae178f",
                  "type":"PartnershipMember"
                }
              }
            },
            "type":"ItemMember"
          }
        ]
      },
      "requester":{
        "data":{
          "id":"451795f6-f54f-4861-ba55-6c22b097a6e4",
          "type":"Membership"
        }
      }
    },
    "type":"Item"
  }
}
{
  "data":{
    "type":"Item",
    "id":"cad5a7ff-e4a6-4750-9f45-2652c62d214a",
    "attributes":{
      "amount":"5000.00",
      "amount_due":"5000.00",
      "amount_paid":"0.00",
      "check_number":null,
      "date_approved":null,
      "date_due":"2021-03-23",
      "date_expected":null,
      "date_externally_paid":null,
      "date_issued":"2021-03-23",
      "date_scheduled":null,
      "date_sent":"2021-03-23",
      "date_status_change":"2021-03-23T23:11:01.948726Z",
      "days_until_due":0,
      "external_ref":null,
      "externally_paid_method":null,
      "externally_paid_reference":null,
      "funding_provider_memo":null,
      "has_attachments":false,
      "invoice_number":null,
      "is_creator":true,
      "kind":"payable",
      "ledger_ref":null,
      "ledger_status":"no_ledger",
      "payment_delivery_method":"check",
      "payment_delivery_methods_accepted":[
        "check"
      ],
      "payment_delivery_option":"check_standard",
      "payment_terms":null,
      "reference":"Invoice #4245",
      "status":"processing",
      "status_timeline":[
        {
          "date":"2021-03-23T23:11:01.948726Z",
          "status":"processing"
        }
      ]
    },
    "relationships":{
      "approvals":{
        "data":[
          
        ]
      },
      "attachments":{
        "meta":{
          "count":0
        },
        "data":[
          
        ]
      },
      "funding_account":{
        "data":{
          "type":"FundingAccount",
          "id":"01c4039a-644a-4f60-9085-23890208336e"
        }
      },
      "item_members":{
        "meta":{
          "count":2
        },
        "data":[
          {
            "type":"ItemMember",
            "id":"235f1107-1020-4be9-b678-ba2aee67b02d"
          },
          {
            "type":"ItemMember",
            "id":"32820145-9fa6-413c-b7ab-ae0c6887f2ff"
          }
        ]
      },
      "partner":{
        "data":{
          "type":"Company",
          "id":"5c81ac75-1599-4991-987a-8418d92698f2"
        }
      },
      "partner_funding_account":{
        "data":{
          "type":"FundingAccount",
          "id":"1148eea4-5134-4b4f-8031-a59cd81a52e2"
        }
      },
      "partnership":{
        "data":{
          "type":"Partnership",
          "id":"a99945e9-815a-4ba7-9e57-cc88972d0222"
        }
      },
      "tag_links":{
        "data":[
          
        ]
      }
    }
  },
  "included":[
    {
      "type":"Company",
      "id":"5c81ac75-1599-4991-987a-8418d92698f2",
      "attributes":{
        "name":"InstaWork"
      }
    },
    {
      "type":"FundingAccount",
      "id":"01c4039a-644a-4f60-9085-23890208336e",
      "attributes":{
        
      },
      "relationships":{
        "address":{
          "data":null
        },
        "bank":{
          "data":{
            "type":"FundingInfoBank",
            "id":"539f5941-643d-4db1-a235-31d3c9a512f1"
          }
        },
        "company":{
          "data":{
            "type":"Company",
            "id":"e4163ce1-dc78-47a0-ae6c-68aab52411e8"
          }
        }
      }
    },
    {
      "type":"FundingAccount",
      "id":"1148eea4-5134-4b4f-8031-a59cd81a52e2",
      "attributes":{
        
      },
      "relationships":{
        "address":{
          "data":{
            "type":"FundingInfoAddress",
            "id":"0ddd3d24-3d96-4613-91cd-89ae85980bec"
          }
        },
        "bank":{
          "data":null
        },
        "company":{
          "data":{
            "type":"Company",
            "id":"5c81ac75-1599-4991-987a-8418d92698f2"
          }
        }
      }
    },
    {
      "type":"FundingInfoAddress",
      "id":"0ddd3d24-3d96-4613-91cd-89ae85980bec",
      "attributes":{
        "city":"Seattle",
        "country":"US",
        "postalcode":"98101",
        "print_company":"InstaWork",
        "print_name":null,
        "state":"WA",
        "street_address":"1110 3rd Ave",
        "street_address_unit":null
      }
    },
    {
      "type":"FundingInfoBank",
      "id":"539f5941-643d-4db1-a235-31d3c9a512f1",
      "attributes":{
        "account_number":"49604",
        "institution_name":"Wells Fargo Bank Na  (Minnesota)",
        "routing_number":"091000019"
      }
    },
    {
      "type":"ItemMember",
      "id":"235f1107-1020-4be9-b678-ba2aee67b02d",
      "attributes":{
        "access_item":"self_managed"
      },
      "relationships":{
        "partnership_member":{
          "data":{
            "type":"PartnershipMember",
            "id":"49c49dfc-60c0-42cf-8bd4-8ec6e4f4ea04"
          }
        }
      }
    },
    {
      "type":"ItemMember",
      "id":"32820145-9fa6-413c-b7ab-ae0c6887f2ff",
      "attributes":{
        "access_item":"actionable"
      },
      "relationships":{
        "partnership_member":{
          "data":{
            "type":"PartnershipMember",
            "id":"082ddd91-5882-48d5-8253-c3e550ae178f"
          }
        }
      }
    },
    {
      "type":"Partnership",
      "id":"a99945e9-815a-4ba7-9e57-cc88972d0222",
      "attributes":{
        "customer_ref":null,
        "name":"InstaWork",
        "vendor_ref":null
      }
    },
    {
      "type":"PartnershipMember",
      "id":"082ddd91-5882-48d5-8253-c3e550ae178f",
      "attributes":{
        "avatar":null,
        "default_general":"actionable",
        "default_item":"actionable",
        "email":"[email protected]",
        "first_name":"Zaldy",
        "is_archived":false,
        "last_name":"Worker",
        "notification_general":"actionable",
        "phone_number":null
      },
      "relationships":{
        "company":{
          "data":{
            "type":"Company",
            "id":"5c81ac75-1599-4991-987a-8418d92698f2"
          }
        },
        "membership":{
          "data":{
            "type":"Membership",
            "id":"5a1a689f-c4f7-4cbc-b4e4-ff94a8b8d675"
          }
        },
        "notification_bounce":{
          "data":null
        }
      }
    },
    {
      "type":"PartnershipMember",
      "id":"49c49dfc-60c0-42cf-8bd4-8ec6e4f4ea04",
      "attributes":{
        "avatar":null,
        "default_general":"self_managed",
        "default_item":"self_managed",
        "email":"[email protected]",
        "first_name":"Kevin",
        "is_archived":false,
        "last_name":"Malone",
        "notification_general":"self_managed",
        "phone_number":{
          "number":"+11917280016",
          "country":"US"
        }
      },
      "relationships":{
        "company":{
          "data":{
            "type":"Company",
            "id":"e4163ce1-dc78-47a0-ae6c-68aab52411e8"
          }
        },
        "membership":{
          "data":{
            "type":"Membership",
            "id":"451795f6-f54f-4861-ba55-6c22b097a6e4"
          }
        },
        "notification_bounce":{
          "data":null
        }
      }
    }
  ]
}

Did this page help you?