Recipes
Adding sub customer details to FX Transaction
there are 2 options to add your customer details to a fx transaction option 1 add your customer prior to the creation of a fx transaction 1 create a sub customer when you https //app archbee com/docs/c6tlpvkilkaql4 krz072/i60lgwocapfhuhhei3yhd , please enter individual or company in the "sub customer account type name" there are specific required data fields for each account type please refer to the table below for individual for company first name (mandatory) company name (mandatory) last name (mandatory) company registration number email email mobile mobile address line 1 (mandatory) address line 1 (mandatory) address line 2 address line 2 city city postcode postcode country (mandatory) country (mandatory) once confirmed, you will be presented with a "sub customer id" for usage in docid\ wmcpwdrontdls d6uwgwq responses { "sub customer" { "id" 10262, "status" "active", "gender" null, "birth date" null, "company name" "lemons", "registration number" "12345567", "account type" { "id" 10001, "name" "individual" }, "name" { "first name" "kevin", "middle name" "", "last name" "lowe" }, "country" { "id" 10004, "name" "australia", "country code" "aus" }, "address" { "address line 1" "123 test street", "address line 2" null, "suburb" "kensley", "city" null, "province" "nsw", "postcode" "2034", "country code" "aus" }, "created date" "2026 03 27t11 46 47+11 00", "updated date" "2026 03 27t11 46 47+11 00" } } option 2 add your customer as part of the creation of a fx transaction you can add a your customer details during docid\ wmcpwdrontdls d6uwgwq step below is the request to be added under "transaction payments\[0] sub customers\[0]" into the request sequence request { "transaction" { "base currency id" 0, "base currency code" "usd", "counter currency id" 0, "counter currency code" "usd", "base currency amount" 0 1, "counter currency amount" 0 1, "value date" "2026 03 27", "base currency account id" 0, "exchange rate" 0 1, "profit amount" 0 1, "profit percentage" 0 1, "wholesale rate" 0 1, "update rate reason id" 0, "rate id" "3fa85f64 5717 4562 b3fc 2c963f66afa6", "payments" \[ { "beneficiary id" 0, "amount" 0 1, "payment reference" "payment for services", "payment type" "chaps", "transaction reason id" 0, "transaction reason name" "string", "transaction reason other" "string", "sub customer ids" \[ 0 ], "sub customers" \[ { "country id" 0, "country code" "usa", "account type id" 0, "account type name" "individual", "email" "user\@example com", "gender" "male", "birth date" "2026 03 27", "company name" "string", "registration number" "string", "name" { "first name" "john", "middle name" "james", "last name" "doe" }, "mobile" { "isd" "64", "number" "1234567890" }, "phone" { "isd" "64", "number" "1234567890" }, "address" { "address line 1" "123 main st", "address line 2" "string", "suburb" "manhattan", "city" "new york", "province" "ny", "postcode" "10001", "country code" "usa" } } ] } ] } } once confirmed, you will be presented with a "transaction payments\[0] sub customers id" within the docid\ wmcpwdrontdls d6uwgwq response body this means that a deal transaction and sub customer has been created response { "transaction" { "id" 214065, "customer id" 12905, "user id" 13392, "status" "created", "status label" "created", "base currency" { "id" 10004, "name" "australian dollar", "currency code" "aud" }, "counter currency" { "id" 10001, "name" "us dollar", "currency code" "usd" }, "base currency amount" "22 08", "counter currency amount" "15 00", "receipt amount" "52 08", "receipt account" { "id" 10040, "name" "aud account", "receipt text" "bsb 802 985\naccount number 115727675\npayid \n", "bank account" { "account number" "115727675" } }, "fees" "30 00", "payments" \[ { "id" 162318, "status" "pending", "amount" "15 00", "fee" "30 00", "beneficiary" { "id" 24567, "name" { "first name" "peter", "middle name" null, "last name" "rabbit" }, "status" "approved by client", "country" { "id" 10131, "name" "united states", "country code" "usa" }, "currency" { "id" 10001, "name" "us dollar", "currency code" "usd" }, "created date" "2025 11 06t11 22 38+11 00", "updated date" "2025 11 06t11 22 38+11 00" }, "payment reference" null, "payment type" null, "transaction reason" { "id" 10451, "name" "goods trade" }, "sub customers" \[ { "id" 10263, "status" "active", "gender" null, "birth date" null, "company name" "jenny co", "registration number" "23465", "account type" { "id" 10001, "name" "individual" }, "name" { "first name" "jenny", "middle name" null, "last name" "smith" }, "country" { "id" 10004, "name" "australia", "country code" "aus" } } ], "created date" "2026 03 27t14 23 08+11 00", "updated date" "2026 03 27t14 23 08+11 00" } ], "exchange rate" "0 6793", "value date" "2026 03 31", "created date" "2026 03 27t14 23 03+11 00", "updated date" "2026 03 27t14 23 09+11 00" } }