create agreement
POST {{baseUrl}}/payto/agreements
Request Body
{"uid"=>"biz_agreement_G7MQWwkQZIP8vbfH", "purpose"=>"loan", "description"=>"Payment plan for loan #1234", "payment_terms"=>{"type"=>"fixed", "frequency"=>"monthly", "amount"=>10000, "count"=>1}, "debtor"=>{"party_name"=>"Billie Jean Junior", "account_identifier"=>{"type"=>"bban", "value"=>"123456-98765432"}, "ultimate_party_name"=>"Billie Jean Senior"}, "creditor"=>{"party_name"=>"Billie Jean Junior", "account_identifier"=>{"type"=>"bban", "value"=>"123456-98765432"}, "ultimate_party_name"=>"Billie Jean Senior"}, "initiator"=>{"name"=>"Jane's Flowers", "legal_name"=>"Blossoming Flowers Pty Ltd", "abn"=>"56192755287"}, "resolution_requested_before"=>"2022-01-20T12:34:56Z", "validity_start_date"=>"2023-01-01", "validity_end_date"=>"2023-12-31", "sandbox"=>{"simulate"=>"debtor_decline", "delay"=>21769872}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Idempotency-Key | string | Idempotency-Key | |
Content-Type | string | ||
Accept | string |
RESPONSES
status: Created
{"data":{"uid":"biz_agreement_G7MQWwkQZIP8vbfH","state":"cancelled","purpose":"loan","created_at":"2022-01-20T12:34:56+11:00","payment_terms":{"type":"fixed","frequency":"monthly","amount":10000,"max_amount":100000,"count":1,"first_payment_amount":100000,"last_payment_amount":100000,"first_payment_date":"2023-12-31","last_payment_date":"2024-12-31"},"debtor":{"party_name":"Billie Jean Junior","account_identifier":{"type":"bban","value":"123456-98765432"},"ultimate_party_name":"Billie Jean Senior"},"initiator":{"name":"Jane's Flowers","legal_name":"Blossoming Flowers Pty Ltd","abn":"56192755287"},"validity_start_date":"2023-01-01","validity_end_date":"2023-12-31","links":{"self":"https://api.split.cash/payto/agreements/biz_agreement_G7MQWwkQZIP8vbfH"},"state_caused_by":"zepto_system","description":"Payment plan for loan #1234","resolution_requested_before":"2022-01-20T12:34:56Z","creditor":{"party_name":"Billie Jean Junior","account_identifier":{"type":"bban","value":"123456-98765432"},"ultimate_party_name":"Billie Jean Senior"},"state_reason":{"title":"Invalid BSB Number","detail":"The BSB is not valid or is no longer active.","code":"MD08"}}}