{ "variable": [ { "id": "baseUrl", "key": "baseUrl", "type": "string", "name": "string", "value": "https:\/\/partners.staging.goescrow.net" } ], "info": { "name": "GoEscrow API Documentation", "_postman_id": "a24f6ac4-de66-4cce-b512-9762b322f927", "description": "", "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json" }, "item": [ { "name": "System", "description": "", "item": [ { "name": "GET api\/v1\/healthcheck", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/healthcheck", "query": [], "raw": "{{baseUrl}}\/api\/v1\/healthcheck" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [] } ] }, { "name": "Company Management", "description": "Manage Companies", "item": [ { "name": "Lookup a company by ABN", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/companies\/lookup", "query": [ { "key": "abn", "value": "40 650 703 736", "description": "The Australian Business Number. Formatting spaces are accepted.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/companies\/lookup?abn=40%20650%20703%20736" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Looks up an existing company by Australian Business Number. Access is limited to companies represented by a user belonging to the authenticated partner, unless using an internal API key." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"reference\":\"ABC123\",\"name\":\"Acme Corp Pty Ltd\",\"abn\":\"40650703736\",\"acn\":\"004085616\",\"kyb_verified\":true,\"aml_verified\":true,\"aml_verified_at\":\"2026-06-25T00:00:00.000000Z\",\"bank_verified\":true,\"abr_status\":\"Active\",\"representatives\":[{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345679\",\"reference\":\"ABC123\",\"name\":\"Jane Doe\"}]}}", "name": "Company found" }, { "header": [], "code": 404, "body": "{\"message\":\"Company not found or access denied.\"}", "name": "Company not found or access denied" } ] }, { "name": "Create a new company", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/companies", "query": [], "raw": "{{baseUrl}}\/api\/v1\/companies" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"Acme Corp Pty Ltd\",\"abn\":\"40650703736\",\"acn\":\"004085616\",\"email\":\"info@acmecorp.com.au\",\"phone\":\"+61298765432\",\"website\":\"https:\\\/\\\/www.acmecorp.com.au\",\"type\":\"Proprietary Limited\",\"majority_owned_by_another_australian_company\":false,\"majority_owned_by_overseas_person_or_company\":false,\"majority_owned_by_listed_australian_company\":false,\"acting_as_trustee_for_a_trust\":false,\"representatives\":[\"9d2e5c8a-1234-5678-9abc-def012345678\"],\"address\":{\"unit_number\":\"3\",\"street_number\":\"20\",\"street\":\"Company Street\",\"suburb\":\"Melbourne\",\"state\":\"VIC\",\"postcode\":\"3000\",\"country\":\"Australia\"}}" }, "description": "Creates a new company and attaches one or more existing users as its representatives." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":{\"id\":\"comp_123\",\"reference\":\"ABC123\",\"name\":\"Acme Corp Pty Ltd\",\"abn\":\"40650703736\",\"acn\":\"004085616\",\"kyb_verified\":true,\"aml_verified\":true,\"aml_verified_at\":\"2026-06-25T00:00:00.000000Z\",\"bank_verified\":true,\"abr_status\":\"Active\",\"representatives\":[{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"reference\":\"ABC123\",\"name\":\"Jane Doe\"}]}}", "name": "Company created successfully" } ] }, { "name": "Update a company", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/companies\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/companies\/:id", "variable": [ { "id": "company_id", "key": "company_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The company UUID (36-character internal identifier)" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"Acme Corp Pty Ltd\",\"acn\":\"004085616\",\"email\":\"info@acmecorp.com.au\",\"phone\":\"+61298765432\",\"website\":\"https:\\\/\\\/www.acmecorp.com.au\",\"type\":\"Proprietary Limited\",\"majority_owned_by_another_australian_company\":false,\"majority_owned_by_overseas_person_or_company\":false,\"majority_owned_by_listed_australian_company\":false,\"acting_as_trustee_for_a_trust\":false,\"add_representatives\":[\"9d2e5c8a-1234-5678-9abc-def012345678\"],\"remove_representatives\":[\"9d2e5c8a-1234-5678-9abc-def012345679\"],\"address\":{\"unit_number\":\"3\",\"street_number\":\"20\",\"street\":\"Company Street\",\"suburb\":\"Melbourne\",\"state\":\"VIC\",\"postcode\":\"3000\",\"country\":\"Australia\"}}" }, "description": "Updates an existing company. Only provided fields will be updated. ABN must be omitted, even when unchanged; create a new company for a different ABN." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"comp_123\",\"reference\":\"ABC123\",\"name\":\"Acme Corp Pty Ltd\",\"abn\":\"40650703736\",\"acn\":\"004085616\",\"kyb_verified\":true,\"aml_verified\":true,\"aml_verified_at\":\"2026-06-25T00:00:00.000000Z\",\"bank_verified\":true,\"abr_status\":\"Active\",\"representatives\":[{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"reference\":\"ABC123\",\"name\":\"Jane Doe\"}]}}", "name": "Company updated successfully" } ] }, { "name": "Upload company files", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/companies\/:company_id\/files", "query": [], "raw": "{{baseUrl}}\/api\/v1\/companies\/:company_id\/files", "variable": [ { "id": "company_id", "key": "company_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The company UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart\/form-data" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "formdata", "formdata": [ { "key": "files[]", "src": [], "type": "file" } ] }, "description": "Uploads one or more files to a company filing cabinet. The authenticated partner must represent the company." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":[{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"file\":\"a1b2c3d4\\\/document.pdf\",\"filename\":\"document.pdf\",\"created_at\":\"2024-01-15T10:30:00Z\"}]}", "name": "Files uploaded" }, { "header": [], "code": 422, "body": "{\"message\":\"Company not found or access denied.\"}", "name": "Not authorised" } ] } ] }, { "name": "User Management", "description": "Manage Users", "item": [ { "name": "Create a new user", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"first_name\":\"John\",\"last_name\":\"Doe\",\"email\":\"john.doe@example.com\",\"phone\":\"+61412345678\",\"birth_date\":\"1990-01-15\",\"initiate_mobile_verification_flow\":\"yes\",\"address\":{\"unit_number\":\"10B\",\"street_number\":\"123\",\"street\":\"Smith St\",\"suburb\":\"Sydney\",\"state\":\"NSW\",\"postcode\":\"2000\"}}" }, "description": "Creates a new user. Email and phone must be unique. The user will be automatically associated with the authenticated partner. If the authenticated Partner has welcome emails enabled, newly created API users receive a GoEscrow Welcome By Partner email with a 24-hour, single-use password setup link." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"reference\":\"ABC123\",\"first_name\":\"John\",\"last_name\":\"Doe\",\"email\":\"john.doe@example.com\",\"phone\":\"+61412345678\",\"birth_date\":\"1990-01-15\",\"kyc_verified\":false,\"aml_verified\":false,\"aml_verified_at\":null,\"email_verified\":false,\"mobile_verified\":false,\"mobilekyc_verified\":false,\"bank_verified\":false,\"suspended\":false,\"address\":{\"unit_number\":\"10B\",\"street_number\":\"123\",\"street\":\"Smith St\",\"suburb\":\"Sydney\",\"state\":\"NSW\",\"postcode\":\"2000\",\"country\":\"Australia\"}}}", "name": "User created successfully" } ] }, { "name": "Update a user", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:id", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"first_name\":\"John\",\"last_name\":\"Doe\",\"email\":\"john.doe@example.com\",\"phone\":\"+61412345678\",\"birth_date\":\"1990-01-15\",\"address\":{\"unit_number\":\"10B\",\"street_number\":\"123\",\"street\":\"Smith St\",\"suburb\":\"Sydney\",\"state\":\"NSW\",\"postcode\":\"2000\"}}" }, "description": "Updates an existing user for the authenticated partner. Email and phone must remain unique." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"reference\":\"ABC123\",\"first_name\":\"John\",\"last_name\":\"Doe\",\"email\":\"john.doe@example.com\",\"phone\":\"+61412345678\",\"birth_date\":\"1990-01-15\",\"kyc_verified\":false,\"aml_verified\":false,\"aml_verified_at\":null,\"email_verified\":false,\"mobile_verified\":false,\"mobilekyc_verified\":false,\"bank_verified\":false,\"suspended\":false,\"address\":{\"unit_number\":\"10B\",\"street_number\":\"123\",\"street\":\"Smith St\",\"suburb\":\"Sydney\",\"state\":\"NSW\",\"postcode\":\"2000\",\"country\":\"Australia\"}}}", "name": "User updated successfully" } ] }, { "name": "Lookup user or company", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/lookup", "query": [ { "key": "email", "value": "john.doe@example.com", "description": "The user's email address. Supply exactly one of email, phone, or reference.", "disabled": false }, { "key": "phone", "value": "+61412345678", "description": "The user's phone number. Supply exactly one of email, phone, or reference. Accepts 0412345678, +61412345678, or 61412345678.", "disabled": false }, { "key": "reference", "value": "ABC123", "description": "A user or company GoEscrow reference. Supply exactly one of email, phone, or reference.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/users\/lookup?email=john.doe%40example.com&phone=%2B61412345678&reference=ABC123" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Look up an existing user by email, phone, or GoEscrow reference. Company reference matches return only the company name and reference. Exactly one parameter must be provided." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"reference\":\"ABC123\",\"first_name\":\"John\",\"last_name\":\"Doe\",\"email\":\"john.doe@example.com\",\"phone\":\"+61412345678\",\"birth_date\":\"1990-01-15\",\"kyc_verified\":true,\"aml_verified\":true,\"aml_verified_at\":\"2026-06-25T00:00:00.000000Z\",\"email_verified\":true,\"mobile_verified\":true,\"mobilekyc_verified\":true,\"bank_verified\":true,\"suspended\":false,\"address\":{\"unit_number\":\"1\",\"street_number\":\"123\",\"street\":\"Main Street\",\"suburb\":\"Sydney\",\"state\":\"NSW\",\"postcode\":\"2000\",\"country\":\"Australia\"}}}", "name": "User found" }, { "header": [], "code": 200, "body": "{\"data\":{\"name\":\"Acme Corp Pty Ltd\",\"reference\":\"XYZ789\"}}", "name": "Company found by reference; representative and contact details are never returned" }, { "header": [], "code": 404, "body": "{\"message\":\"User or company not found.\"}", "name": "No accessible reference match found" }, { "header": [], "code": 422, "body": "{\"message\":\"At least one of email or phone is required.\"}", "name": "No lookup parameter supplied (legacy user lookup contract)" }, { "header": [], "code": 422, "body": "{\"message\":\"Please provide either email or phone, not both.\"}", "name": "Both legacy user lookup parameters supplied" }, { "header": [], "code": 422, "body": "{\"message\":\"Please provide only one of email, phone, or reference.\"}", "name": "Reference combined with another lookup parameter" } ] }, { "name": "Send mobile verification code", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/verify-mobile", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/verify-mobile", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Sends a verification code via SMS to the user's registered phone number. The code will be valid for a limited time." }, "response": [ { "header": [], "code": 204, "body": "[]", "name": "Verification code sent successfully" } ] }, { "name": "Verify mobile phone", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/verify-mobile", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/verify-mobile", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"code\":\"123456\"}" }, "description": "Verifies the mobile phone number using the code sent via SMS. Upon successful verification, the user's phone will be marked as verified." }, "response": [ { "header": [], "code": 204, "body": "[]", "name": "Phone number verified successfully" } ] }, { "name": "Send email verification code", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/verify-email", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/verify-email", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Sends a verification code via email to the user's registered email address. The code will be valid for a limited time." }, "response": [ { "header": [], "code": 204, "body": "[]", "name": "Verification code sent successfully" } ] }, { "name": "Verify email address", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/verify-email", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/verify-email", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"code\":\"123456\"}" }, "description": "Verifies the email address using the code sent via email. Upon successful verification, the user's email will be marked as verified." }, "response": [ { "header": [], "code": 204, "body": "[]", "name": "Email address verified successfully" } ] }, { "name": "Generate user bank statement", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/bank-statement", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/bank-statement", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Generates and returns a PDF bank statement for the specified user. The statement includes transaction history and account details." }, "response": [ { "header": [], "code": 200, "body": "[]", "name": "PDF bank statement generated successfully" } ] }, { "name": "Upload user files", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/files", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/files", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart\/form-data" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "formdata", "formdata": [ { "key": "files[]", "src": [], "type": "file" } ] }, "description": "Uploads one or more files to a user filing cabinet. The authenticated partner must own the user." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":[{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"file\":\"a1b2c3d4\\\/document.pdf\",\"filename\":\"document.pdf\",\"created_at\":\"2024-01-15T10:30:00Z\"}]}", "name": "Files uploaded" }, { "header": [], "code": 422, "body": "{\"message\":\"User not found or access denied.\"}", "name": "Not authorised" } ] }, { "name": "Generate password reset link", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/password-reset-link", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/password-reset-link", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"send_email\":true}" }, "description": "Generates a short-lived password reset link for the user." }, "response": [ { "header": [], "code": 200, "body": "{\"reset_url\":\"https:\\\/\\\/app.goescrow.com.au\\\/auth\\\/forgot-password\\\/abc123\",\"expires_in\":\"60 minutes\"}", "name": "" } ] } ] }, { "name": "Dispute Management", "description": "Create and manage transaction disputes", "item": [ { "name": "Create a dispute", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/disputes", "query": [], "raw": "{{baseUrl}}\/api\/v1\/disputes" }, "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "6f3a8e1c-9b2d-4f5a-8c1e-2a7b9d0e1f23" }, { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"requester_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"requester_role\":\"buyer\",\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"request_type\":\"pause\",\"issue_description\":\"The goods were not delivered as described.\"}" }, "description": "Creates a dispute for a transaction. This will mark the transaction as disputed and create a compliance note for the CS team to review." }, "response": [ { "header": [], "code": 201, "body": "{\"message\":\"Dispute created successfully.\",\"dispute_reference\":\"DISP-2024-001234\",\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"disputed\"}", "name": "Dispute created" }, { "header": [], "code": 422, "body": "{\"message\":\"Transaction status does not allow disputes.\"}", "name": "Invalid transaction status" } ] } ] }, { "name": "Transaction Cancellation", "description": "Manage cancellation requests and approvals for partner transactions.\n\n### Multiple payees: standard and marketplace Anytime and Timed transactions\n\nA transaction with two or more disbursement entries uses per-party cancellation approval. The API derives the parties from the saved payer and disbursement recipients. Do not include a list of other parties or resend the disbursement array in cancellation requests. All calls below use the existing `\/api\/v1\/transactions\/{transaction_id}` endpoints.\n\n1. POST `\/cancellation-request` with `requester_id`, the requesting user or company UUID. For a company with multiple representatives, also send `representative_id`, the UUID of the linked user acting for that company. Use the same representative for code delivery and verification.\n2. If `requires_2fa` is true, codes have been sent but the request has not yet been created. POST `\/verify-cancellation` with the same actor details, `email_code` and `phone_code` to create it.\n3. Save the returned `cancellation_request_id`. Each other party POSTs `\/cancellation-accept` with its own `accepter_id`, the current `cancellation_request_id` and, where needed, `representative_id`.\n4. If acceptance returns `requires_2fa: true`, that party POSTs `\/verify-cancellation-accept` with the same actor details and request ID, plus `email_code` and `phone_code`.\n5. A party still requiring approval can instead POST `\/cancellation-deny` with `denier_id`, the current `cancellation_request_id` and, where needed, `representative_id`. Denial does not require verification codes.\n\nFor example, an individual requests cancellation without listing the other parties:\n\n```json\n{\"requester_id\": \"9d2e5c8a-1234-5678-9abc-def012345678\"}\n```\n\nAfter the request is created, another party accepts using the returned request ID:\n\n```json\n{\"accepter_id\": \"9d2e5c8a-1234-5678-9abc-def012345680\", \"cancellation_request_id\": \"2c9bb6a0-b123-4567-89ab-0123456789ab\"}\n```\n\nMarketplace cancellation includes the payer and every disbursement recipient, including fee recipients. The marketplace operator is not an additional approval party solely because it is the operator. Beneficiaries confirm receipt of goods or services; they are not cancellation parties. Cancellation can start while beneficiary confirmation is outstanding, and settlement is blocked while cancellation is pending.\n\nThe requester contributes the first approval. With one payer and two distinct payees, all three legal parties must approve; one representative acting for two companies must approve separately for each company. An HTTP 200 can mean only that one approval was recorded. The transaction remains `cancellation_requested` until all required approvals are complete. Check `status` for `canceled`; refund processing may still be pending.\n\nPending multi-payee transactions also require all parties to approve; they are not cancelled immediately. Partially or fully funded multi-payee transactions require email and phone verification for every approval, based on positive, unreversed payment receipts. If funding arrives after an unverified approval, that party must approve again with verification. Codes expire after five minutes and are bound to the transaction, legal party, representative and cancellation attempt.\n\nA missing or stale `cancellation_request_id` on acceptance, acceptance verification or denial returns HTTP 422. Refresh the transaction and use the current ID; do not replay an old approval against a new request. The response ID is null before a request is created and after cancellation or denial ends it. Older active requests without a generated ID return `legacy`; send the returned value unchanged.\n\nDenial normally restores the previous status. Marketplace denial rechecks beneficiary requirements before restoring accepted or awaiting_beneficiary_confirmation. For a multi-payee Timed transaction less than 12 hours before a future release, denial instead sets `contact_helpdesk`, suspends payee settlements and alerts customer service.\n\nSingle-payee and Super Disbursement transactions retain their existing cancellation flow. The multi-payee-only fields and approval rules below do not change that flow.", "item": [ { "name": "Request transaction cancellation", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions\/:transaction_id\/cancellation-request", "query": [], "raw": "{{baseUrl}}\/api\/v1\/transactions\/:transaction_id\/cancellation-request", "variable": [ { "id": "transaction_id", "key": "transaction_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The transaction UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "6f3a8e1c-9b2d-4f5a-8c1e-2a7b9d0e1f23" }, { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"requester_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"representative_id\":\"9d2e5c8a-1234-5678-9abc-def012345679\"}" }, "description": "Initiates cancellation. For standard and marketplace multi-payee Anytime and Timed transactions, supply only the requesting party ID and, when needed, its representative ID; the API already knows the other parties. Unfunded pending, accepted or awaiting_beneficiary_confirmation transactions enter cancellation_requested with the requester approval recorded. If requires_2fa is true, call verify-cancellation to create the request. Single-payee pending transactions retain immediate cancellation; accepted transactions retain the existing counterparty flow." }, "response": [ { "header": [], "code": 200, "body": "{\"message\":\"Cancellation requested. 2FA verification required. Codes sent to requester's email and phone.\",\"requires_2fa\":true,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"accepted\"}", "name": "2FA required for funded accepted transaction" }, { "header": [], "code": 200, "body": "{\"message\":\"Cancellation requested. Waiting for counterparty response.\",\"requires_2fa\":false,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"cancellation_requested\"}", "name": "Cancellation request created" }, { "header": [], "code": 200, "body": "{\"message\":\"Transaction cancelled successfully.\",\"requires_2fa\":false,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"canceled\"}", "name": "Single-payee pending transaction cancelled" }, { "header": [], "code": 200, "body": "{\"message\":\"Approval recorded. Waiting for the remaining parties.\",\"requires_2fa\":false,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"cancellation_requested\",\"cancellation_request_id\":\"2c9bb6a0-b123-4567-89ab-0123456789ab\"}", "name": "Multi-payee approval recorded; other parties must still approve" }, { "header": [], "code": 200, "body": "{\"message\":\"Verification codes sent. Verify them to record this party\\u2019s approval.\",\"requires_2fa\":true,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"accepted\",\"cancellation_request_id\":null}", "name": "Multi-payee verification codes sent; approval not yet recorded" } ] }, { "name": "Verify cancellation request 2FA codes", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions\/:transaction_id\/verify-cancellation", "query": [], "raw": "{{baseUrl}}\/api\/v1\/transactions\/:transaction_id\/verify-cancellation", "variable": [ { "id": "transaction_id", "key": "transaction_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The transaction UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"requester_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"email_code\":\"123456\",\"phone_code\":\"654321\",\"representative_id\":\"9d2e5c8a-1234-5678-9abc-def012345679\"}" }, "description": "Verifies requester codes and creates the cancellation request. For multi-payee transactions, this records only the requester approval and returns cancellation_request_id for the remaining parties. Use the same requester_id and representative_id as the code-delivery call. No cancellation_request_id is needed to create the request." }, "response": [ { "header": [], "code": 200, "body": "{\"message\":\"Cancellation requested. Waiting for counterparty response.\",\"requires_2fa\":false,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"cancellation_requested\"}", "name": "Cancellation request created" }, { "header": [], "code": 200, "body": "{\"message\":\"Approval recorded. Waiting for the remaining parties.\",\"requires_2fa\":false,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"cancellation_requested\",\"cancellation_request_id\":\"2c9bb6a0-b123-4567-89ab-0123456789ab\"}", "name": "Multi-payee approval recorded; other parties must still approve" }, { "header": [], "code": 422, "body": "{\"message\":\"Invalid or expired verification codes.\"}", "name": "Invalid codes" } ] }, { "name": "Accept transaction cancellation", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions\/:transaction_id\/cancellation-accept", "query": [], "raw": "{{baseUrl}}\/api\/v1\/transactions\/:transaction_id\/cancellation-accept", "variable": [ { "id": "transaction_id", "key": "transaction_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The transaction UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"accepter_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"representative_id\":\"9d2e5c8a-1234-5678-9abc-def012345679\",\"cancellation_request_id\":\"2c9bb6a0-b123-4567-89ab-0123456789ab\"}" }, "description": "Records approval from one outstanding party. Multi-payee requests require the current cancellation_request_id. If requires_2fa is true, codes were sent but approval is not yet recorded: call verify-cancellation-accept. Otherwise HTTP 200 may still have status cancellation_requested while other approvals are outstanding. Only the final required approval completes cancellation. Single-payee requests retain the existing counterparty flow." }, "response": [ { "header": [], "code": 200, "body": "{\"message\":\"Cancellation acceptance requires 2FA verification. Codes sent to accepter's email and phone.\",\"requires_2fa\":true,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"cancellation_requested\"}", "name": "2FA required for funded transaction" }, { "header": [], "code": 200, "body": "{\"message\":\"Cancellation accepted. Transaction cancelled successfully.\",\"requires_2fa\":false,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"canceled\"}", "name": "Cancellation accepted" }, { "header": [], "code": 200, "body": "{\"message\":\"Approval recorded. Waiting for the remaining parties.\",\"requires_2fa\":false,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"cancellation_requested\",\"cancellation_request_id\":\"2c9bb6a0-b123-4567-89ab-0123456789ab\"}", "name": "Multi-payee approval recorded; other parties must still approve" }, { "header": [], "code": 200, "body": "{\"message\":\"Verification codes sent. Verify them to record this party\\u2019s approval.\",\"requires_2fa\":true,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"cancellation_requested\",\"cancellation_request_id\":\"2c9bb6a0-b123-4567-89ab-0123456789ab\"}", "name": "Multi-payee verification codes sent; approval not yet recorded" }, { "header": [], "code": 200, "body": "{\"message\":\"All parties approved. Transaction cancelled.\",\"requires_2fa\":false,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"canceled\",\"cancellation_request_id\":null}", "name": "Multi-payee final approval completes cancellation" }, { "header": [], "code": 422, "body": "{\"message\":\"The cancellation request has changed. Refresh the transaction and try again.\",\"errors\":{\"cancellation_request_id\":[\"The cancellation request has changed. Refresh the transaction and try again.\"]}}", "name": "Multi-payee cancellation request ID missing or stale" } ] }, { "name": "Verify cancellation acceptance 2FA codes", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions\/:transaction_id\/verify-cancellation-accept", "query": [], "raw": "{{baseUrl}}\/api\/v1\/transactions\/:transaction_id\/verify-cancellation-accept", "variable": [ { "id": "transaction_id", "key": "transaction_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The transaction UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"accepter_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"email_code\":\"123456\",\"phone_code\":\"654321\",\"representative_id\":\"9d2e5c8a-1234-5678-9abc-def012345679\",\"cancellation_request_id\":\"2c9bb6a0-b123-4567-89ab-0123456789ab\"}" }, "description": "Verifies one party approval using email_code and phone_code. For multi-payee transactions, include the current cancellation_request_id and use the same accepter_id and representative_id as the code-delivery call. Cancellation remains pending until the payer and every payee have approved with any required verification." }, "response": [ { "header": [], "code": 200, "body": "{\"message\":\"Cancellation accepted. Transaction cancelled successfully.\",\"requires_2fa\":false,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"canceled\"}", "name": "Cancellation accepted" }, { "header": [], "code": 200, "body": "{\"message\":\"Approval recorded. Waiting for the remaining parties.\",\"requires_2fa\":false,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"cancellation_requested\",\"cancellation_request_id\":\"2c9bb6a0-b123-4567-89ab-0123456789ab\"}", "name": "Multi-payee approval recorded; other parties must still approve" }, { "header": [], "code": 200, "body": "{\"message\":\"All parties approved. Transaction cancelled.\",\"requires_2fa\":false,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"canceled\",\"cancellation_request_id\":null}", "name": "Multi-payee final approval completes cancellation" }, { "header": [], "code": 422, "body": "{\"message\":\"Invalid or expired verification codes.\"}", "name": "Invalid codes" }, { "header": [], "code": 422, "body": "{\"message\":\"The cancellation request has changed. Refresh the transaction and try again.\",\"errors\":{\"cancellation_request_id\":[\"The cancellation request has changed. Refresh the transaction and try again.\"]}}", "name": "Multi-payee cancellation request ID missing or stale" } ] }, { "name": "Deny transaction cancellation", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions\/:transaction_id\/cancellation-deny", "query": [], "raw": "{{baseUrl}}\/api\/v1\/transactions\/:transaction_id\/cancellation-deny", "variable": [ { "id": "transaction_id", "key": "transaction_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The transaction UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"denier_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"representative_id\":\"9d2e5c8a-1234-5678-9abc-def012345679\",\"cancellation_request_id\":\"2c9bb6a0-b123-4567-89ab-0123456789ab\"}" }, "description": "Denies an active cancellation request without verification codes. For multi-payee transactions, only a party still requiring approval may deny; supply the current cancellation_request_id. Normally restores the previous status. Within 12 hours before a future Timed release, multi-payee denial instead sets contact_helpdesk, suspends payee settlements and alerts customer service. Single-payee requests retain their existing denial flow." }, "response": [ { "header": [], "code": 200, "body": "{\"message\":\"Cancellation denied. Transaction reverted to active status.\",\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"accepted\"}", "name": "Cancellation denied" }, { "header": [], "code": 200, "body": "{\"message\":\"Cancellation denied. Transaction is active again.\",\"requires_2fa\":false,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"accepted\",\"cancellation_request_id\":null}", "name": "Multi-payee cancellation denied; previous status restored" }, { "header": [], "code": 200, "body": "{\"message\":\"Transaction under review. CS Team has been notified.\",\"requires_2fa\":false,\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"contact_helpdesk\",\"cancellation_request_id\":null}", "name": "Multi-payee Timed cancellation denial requires safety review" }, { "header": [], "code": 422, "body": "{\"message\":\"The cancellation request has changed. Refresh the transaction and try again.\",\"errors\":{\"cancellation_request_id\":[\"The cancellation request has changed. Refresh the transaction and try again.\"]}}", "name": "Multi-payee cancellation request ID missing or stale" } ] } ] }, { "name": "Transaction Management", "description": "Manage Transactions", "item": [ { "name": "Create transaction", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions", "query": [], "raw": "{{baseUrl}}\/api\/v1\/transactions" }, "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "6f3a8e1c-9b2d-4f5a-8c1e-2a7b9d0e1f23" }, { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"action\":\"buy\",\"type\":\"anytime_escrow\",\"amount_type\":\"escrow\",\"other_user\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"other_company_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"sub_type\":\"marketplace\",\"user_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"company_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"marketplace_operator_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"release_at\":\"2024-12-31T23:59:59Z\",\"details\":\"Dental Surgery\",\"amount\":15000050,\"disbursements\":[\"reprehenderit\"],\"beneficiaries\":[{\"first_name\":\"Greg\",\"last_name\":\"Recipient\",\"mobile\":\"+61400000001\",\"required\":true}]}" }, "description": "Creates a new escrow transaction with disbursements. Partner API transactions are auto-accepted (skip pending status)." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"reference\":\"TXN-2024-001234\",\"type\":\"anytime_escrow\",\"sub_type\":\"marketplace\",\"status\":\"accepted\",\"funding_status\":\"pending\",\"amount\":150000.5,\"details\":\"Property settlement for 123 Main St\",\"created_at\":\"2024-01-15T10:30:00Z\",\"beneficiaries\":[{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345679\",\"first_name\":\"G**g\",\"last_name\":\"R*******t\",\"mobile\":\"+61******001\",\"required\":true,\"status\":\"pending\"}]}}", "name": "Transaction created successfully" }, { "header": [], "code": 422, "body": "{\"message\":\"This company is not currently eligible to transact.\",\"errors\":{\"company_id\":[\"This company is not currently eligible to transact.\"]}}", "name": "A company is inaccessible or ineligible, the parties are self-dealing, or a disbursement does not identify exactly one recipient" } ] }, { "name": "Get transaction status by identifier", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions\/status", "query": [ { "key": "transaction_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The transaction UUID (36-character internal identifier). Required when reference_id is not provided. Must not be provided with reference_id.", "disabled": false }, { "key": "reference_id", "value": "TXN-2024-001234", "description": "The transaction reference number. Required when transaction_id is not provided. Must not be provided with transaction_id.", "disabled": false }, { "key": "party_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The ID of the buyer, seller, or disbursement recipient to verify access", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/transactions\/status?transaction_id=9d2e5c8a-1234-5678-9abc-def012345678&reference_id=TXN-2024-001234&party_id=9d2e5c8a-1234-5678-9abc-def012345678" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"transaction_id\":\"fac6745b-d8fd-3df8-bad7-64b3a0a8d271\",\"reference_id\":\"delectus\",\"party_id\":\"32fbd4f4-b19d-3de9-84fa-3ff4c85c1f85\"}" }, "description": "Returns full transaction details including funding information. Provide exactly one of transaction_id or reference_id. Requires party_id to verify access." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"reference\":\"TXN-2024-001234\",\"type\":\"anytime_escrow\",\"sub_type\":\"marketplace\",\"status\":\"accepted\",\"funding_status\":\"pending\",\"amount\":150000.5,\"fee\":1500,\"amount_with_fee\":151500.5,\"details\":\"Property settlement\",\"release_at\":null,\"created_at\":\"2024-01-15T10:30:00Z\",\"buyer_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"buyer_reference\":\"ABC123\",\"seller_id\":\"9d2e5c8a-1234-5678-9abc-def012345679\",\"seller_reference\":\"XYZ789\",\"other_party_hint\":\"J*** D***\",\"funding_details\":{\"bsb\":\"123456\",\"account_number\":\"12345678\",\"account_name\":\"GoEscrow Trust\",\"pay_id\":\"pay@goescrow.com.au\",\"reference\":\"TXN-2024-001234\",\"rail\":\"azupay\",\"account_scope\":\"transaction\",\"payment_reference\":\"TXN-2024-001234\",\"reference_required\":false,\"provisioning_status\":\"ready\",\"amount_received\":\"0.00\",\"amount_outstanding\":\"151500.50\"}}}", "name": "Transaction details" } ] }, { "name": "Get transaction status", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions\/:id", "query": [ { "key": "party_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The ID of the buyer or seller to verify access", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/transactions\/:id?party_id=9d2e5c8a-1234-5678-9abc-def012345678", "variable": [ { "id": "transaction_id", "key": "transaction_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The transaction UUID (36-character internal identifier)" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns full transaction details including funding information. Requires party_id to verify access." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"reference\":\"TXN-2024-001234\",\"type\":\"anytime_escrow\",\"sub_type\":\"marketplace\",\"status\":\"accepted\",\"funding_status\":\"pending\",\"amount\":150000.5,\"fee\":1500,\"amount_with_fee\":151500.5,\"details\":\"Property settlement\",\"release_at\":null,\"created_at\":\"2024-01-15T10:30:00Z\",\"buyer_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"buyer_reference\":\"ABC123\",\"seller_id\":\"9d2e5c8a-1234-5678-9abc-def012345679\",\"seller_reference\":\"XYZ789\",\"other_party_hint\":\"J*** D***\",\"funding_details\":{\"bsb\":\"123456\",\"account_number\":\"12345678\",\"account_name\":\"GoEscrow Trust\",\"pay_id\":\"pay@goescrow.com.au\",\"reference\":\"TXN-2024-001234\",\"rail\":\"azupay\",\"account_scope\":\"transaction\",\"payment_reference\":\"TXN-2024-001234\",\"reference_required\":false,\"provisioning_status\":\"ready\",\"amount_received\":\"0.00\",\"amount_outstanding\":\"151500.50\"}}}", "name": "Transaction details" } ] }, { "name": "Request beneficiary confirmation", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions\/:transaction_id\/beneficiaries\/:beneficiary_id\/confirmation-request", "query": [], "raw": "{{baseUrl}}\/api\/v1\/transactions\/:transaction_id\/beneficiaries\/:beneficiary_id\/confirmation-request", "variable": [ { "id": "transaction", "key": "transaction", "value": "eum", "description": "The transaction UUID" }, { "id": "beneficiary", "key": "beneficiary", "value": "sed", "description": "The beneficiary UUID" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"heading\":\"Confirm your session\"}" }, "description": "Creates or rotates a single-use beneficiary confirmation link and sends it by SMS to the beneficiary. The token and confirmation URL are not returned to the partner." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":{\"message\":\"Confirmation link sent\",\"beneficiary_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"sent_to\":\"+614****5678\",\"expires_at\":\"2026-08-16T12:00:00+00:00\",\"heading\":\"Confirm receipt\"}}", "name": "Confirmation link sent by SMS" } ] }, { "name": "Get transaction quote", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions\/quote", "query": [], "raw": "{{baseUrl}}\/api\/v1\/transactions\/quote" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"action\":\"buy\",\"type\":\"anytime_escrow\",\"amount_type\":\"escrow\",\"other_user\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"other_company_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"sub_type\":\"super_disbursement\",\"user_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"company_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"release_at\":\"2024-12-31T23:59:59Z\",\"details\":\"Dental Surgery\",\"amount\":15000050,\"disbursements\":[\"natus\"]}" }, "description": "Calculates fees and provides a quote for a transaction without creating it. Uses the same request structure as transaction creation. This allows partners to show pricing to their customers before committing to a transaction." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":{\"sub_type\":\"super_disbursement\",\"amount\":150000.5,\"partner_fee\":299.4,\"partner_fee_percentage\":0.2,\"goescrow_fee\":0,\"goescrow_fee_percentage\":0,\"total_fees\":299.4,\"net_amount\":149701.1,\"disbursements_count\":2,\"disbursements\":[{\"user_id\":\"9d2e5c8a-1234-5678-9abc-def012345679\",\"amount\":74850.55},{\"company_id\":\"9d2e5c8a-1234-5678-9abc-def012345680\",\"amount\":74850.55}]}}", "name": "Transaction quote calculated successfully" } ] }, { "name": "Upload transaction files", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions\/:transaction_id\/files", "query": [], "raw": "{{baseUrl}}\/api\/v1\/transactions\/:transaction_id\/files", "variable": [ { "id": "transaction_id", "key": "transaction_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The transaction UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart\/form-data" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "formdata", "formdata": [ { "key": "files[]", "src": [], "type": "file" } ] }, "description": "Uploads one or more files to a transaction filing cabinet. The authenticated partner must own the transaction or be its marketplace operator." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":[{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"file\":\"a1b2c3d4\\\/document.pdf\",\"filename\":\"document.pdf\",\"created_at\":\"2024-01-15T10:30:00Z\"}]}", "name": "Files uploaded" }, { "header": [], "code": 422, "body": "{\"message\":\"Transaction not found or access denied.\"}", "name": "Not authorised" } ] }, { "name": "Trigger marketplace settlement", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions\/:transaction_id\/settle", "query": [], "raw": "{{baseUrl}}\/api\/v1\/transactions\/:transaction_id\/settle", "variable": [ { "id": "transaction_id", "key": "transaction_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The transaction UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "6f3a8e1c-9b2d-4f5a-8c1e-2a7b9d0e1f23" }, { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"buyer_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"seller_id\":\"9d2e5c8a-1234-5678-9abc-def012345679\",\"settlement_amount\":150000.5}" }, "description": "Triggers settlement for a marketplace escrow transaction. Only the marketplace operator can trigger settlement." }, "response": [ { "header": [], "code": 200, "body": "{\"message\":\"Settlement initiated successfully.\",\"transaction_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"status\":\"settlement_in_progress\"}", "name": "Settlement initiated" }, { "header": [], "code": 403, "body": "{\"message\":\"Only the marketplace operator can trigger settlement.\"}", "name": "Not authorized" }, { "header": [], "code": 422, "body": "{\"message\":\"Only marketplace escrow transactions can be settled via API.\"}", "name": "Invalid transaction type" } ] } ] }, { "name": "Transaction PayTo Payment", "description": "Initiate PayTo Payments for Transactions", "item": [ { "name": "Initiate PayTo payment", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions\/:transaction_id\/payto-payment", "query": [], "raw": "{{baseUrl}}\/api\/v1\/transactions\/:transaction_id\/payto-payment", "variable": [ { "id": "transaction_id", "key": "transaction_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The transaction UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "6f3a8e1c-9b2d-4f5a-8c1e-2a7b9d0e1f23" }, { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"user_id\":\"9d2e5c8a-1234-5678-9abc-def012345678\"}" }, "description": "Initiates a PayTo debit payment from the specified user's bank account to fund the transaction. The user must have an active PayTo agreement. This endpoint dispatches an async job and returns immediately with a tracking ID." }, "response": [ { "header": [], "code": 202, "body": "{\"code\":\"accepted\",\"message\":\"Payment initiation queued. Use the tracking_id to poll for status.\",\"tracking_id\":\"payto_9d2e5c8a\"}", "name": "Payment initiation queued for processing" }, { "header": [], "code": 400, "body": "{\"code\":\"transaction_already_funded\",\"message\":\"This transaction is already funded.\"}", "name": "Transaction already funded" }, { "header": [], "code": 400, "body": "{\"code\":\"no_payment_agreement\",\"message\":\"User does not have a PayTo agreement set up.\"}", "name": "PayTo not configured" } ] }, { "name": "Check PayTo payment status", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/transactions\/:transaction_id\/payto-payment\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/transactions\/:transaction_id\/payto-payment\/:id", "variable": [ { "id": "transaction_id", "key": "transaction_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The transaction UUID (36-character internal identifier)" }, { "id": "id", "key": "id", "value": "payto_abc123", "description": "Either a tracking_id (e.g., payto_abc123) or an Azupay payment_initiation_id (e.g., PI-123456789)" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Checks the status of a PayTo payment using either a tracking_id (from async initiation) or a payment_initiation_id (from Azupay)." }, "response": [ { "header": [], "code": 200, "body": "{\"code\":\"settled\",\"message\":\"Payment settled successfully. Transaction is now funded.\",\"status\":\"settled\"}", "name": "Payment settled" }, { "header": [], "code": 200, "body": "{\"code\":\"pending\",\"message\":\"Payment is still processing.\",\"status\":\"pending\"}", "name": "Payment pending" }, { "header": [], "code": 200, "body": "{\"code\":\"failed\",\"message\":\"Payment was rejected.\",\"status\":\"failed\"}", "name": "Payment failed" }, { "header": [], "code": 200, "body": "{\"code\":\"queued\",\"message\":\"Payment initiation is queued for processing.\",\"status\":\"queued\"}", "name": "Job queued" } ] } ] }, { "name": "User Bank Account Management", "description": "Manage User Bank Accounts", "item": [ { "name": "Update user bank account", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/bank-account", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/bank-account", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"bsb_number\":\"123456\",\"account_number\":\"12345678\",\"account_name\":\"John Doe\"}" }, "description": "Updates the bank account details for a user. This will automatically trigger a verification payout of $0.01 to the new account with a 6-digit verification code in the transaction description." }, "response": [ { "header": [], "code": 200, "body": "{\"message\":\"Bank account updated. Verification code sent via $0.01 payout.\",\"is_verified\":false}", "name": "Bank account updated successfully" } ] }, { "name": "Verify user bank account", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/bank-account\/verify", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/bank-account\/verify", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"code\":\"123456\"}" }, "description": "Verifies the bank account using the 6-digit code received in the $0.01 verification payout." }, "response": [ { "header": [], "code": 200, "body": "{\"message\":\"Bank account verified successfully.\",\"is_verified\":true}", "name": "Bank account verified successfully" }, { "header": [], "code": 422, "body": "{\"message\":\"The verification code is incorrect.\"}", "name": "Invalid verification code" } ] } ] }, { "name": "User Identification Management", "description": "Manage User Identification Documents", "item": [ { "name": "Create or update user passport", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/passport", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/passport", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"document_number\":\"N1234567\",\"first_name\":\"John\",\"last_name\":\"Doe\",\"middle_name\":\"Michael\",\"issuing_country\":\"United Kingdom\",\"nationality\":\"British\",\"date_of_birth\":\"1990-01-15\",\"date_of_issue\":\"2020-01-15\",\"date_of_expiration\":\"2030-01-15\",\"place_of_birth\":\"Sydney, Australia\",\"gender\":\"M\"}" }, "description": "Creates a new passport record for the user or updates an existing one. Only one passport per user is allowed." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"document_number\":\"N1234567\",\"first_name\":\"John\",\"last_name\":\"Doe\",\"middle_name\":\"Michael\",\"nationality\":\"United Kingdom\",\"issuing_country\":\"United Kingdom\",\"date_of_birth\":\"1990-01-15\",\"date_of_issue\":\"2020-01-15\",\"date_of_expiration\":\"2030-01-15\",\"place_of_birth\":\"Sydney, Australia\",\"gender\":\"M\",\"rapidid_verification_requested_at\":null,\"rapidid_verified_at\":null,\"rapidid_failed_at\":null,\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-15T10:30:00Z\"}}", "name": "Passport created\/updated successfully" } ] }, { "name": "Get user passport", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/passport", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/passport", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves the passport information for the specified user." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"document_number\":\"N1234567\",\"first_name\":\"John\",\"last_name\":\"Doe\",\"middle_name\":\"Michael\",\"nationality\":\"United Kingdom\",\"issuing_country\":\"United Kingdom\",\"date_of_birth\":\"1990-01-15\",\"date_of_issue\":\"2020-01-15\",\"date_of_expiration\":\"2030-01-15\",\"place_of_birth\":\"Sydney, Australia\",\"gender\":\"M\",\"rapidid_verification_requested_at\":null,\"rapidid_verified_at\":null,\"rapidid_failed_at\":null,\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-15T10:30:00Z\"}}", "name": "Passport retrieved successfully" }, { "header": [], "code": 404, "body": "{\"error\":\"Passport not found for this user.\"}", "name": "Passport not found" } ] }, { "name": "Delete user passport", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/passport", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/passport", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Deletes the passport record for the specified user." }, "response": [ { "header": [], "code": 204, "body": "[]", "name": "Passport deleted successfully" }, { "header": [], "code": 404, "body": "{\"error\":\"Passport not found for this user.\"}", "name": "Passport not found" } ] }, { "name": "Create or update user Medicare card", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/medicare", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/medicare", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"document_number\":\"1234567890\",\"name_on_card\":\"John Michael Doe\",\"card_color\":\"green\",\"individual_reference_number\":\"1\",\"expiration_date\":\"2025-12\"}" }, "description": "Creates a new Medicare card record for the user or updates an existing one. Only one Medicare card per user is allowed." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"document_number\":\"1234567890\",\"name_on_card\":\"John Michael Doe\",\"card_color\":\"green\",\"individual_reference_number\":\"1\",\"expiration_date\":\"2025-12\",\"rapidid_verification_requested_at\":null,\"rapidid_verified_at\":null,\"rapidid_failed_at\":null,\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-15T10:30:00Z\"}}", "name": "Medicare card created\/updated successfully" } ] }, { "name": "Get user Medicare card", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/medicare", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/medicare", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves the Medicare card information for the specified user." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"document_number\":\"1234567890\",\"name_on_card\":\"John Michael Doe\",\"card_color\":\"green\",\"individual_reference_number\":\"1\",\"expiration_date\":\"2025-12\",\"rapidid_verification_requested_at\":null,\"rapidid_verified_at\":null,\"rapidid_failed_at\":null,\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-15T10:30:00Z\"}}", "name": "Medicare card retrieved successfully" }, { "header": [], "code": 404, "body": "{\"error\":\"Medicare card not found for this user.\"}", "name": "Medicare card not found" } ] }, { "name": "Delete user Medicare card", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/medicare", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/medicare", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Deletes the Medicare card record for the specified user." }, "response": [ { "header": [], "code": 204, "body": "[]", "name": "Medicare card deleted successfully" }, { "header": [], "code": 404, "body": "{\"error\":\"Medicare card not found for this user.\"}", "name": "Medicare card not found" } ] }, { "name": "Create or update user driver license", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/driver-license", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/driver-license", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"state_issued\":\"NSW\",\"license_number\":\"12345678\",\"card_number\":\"1234567890\",\"expiration_date\":\"2030-01-15\",\"first_name\":\"John\",\"last_name\":\"Doe\",\"middle_name\":\"Michael\",\"date_of_birth\":\"1990-01-15\"}" }, "description": "Creates a new driver license record for the user or updates an existing one. Only one driver license per user is allowed." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"state_issued\":\"NSW\",\"license_number\":\"12345678\",\"card_number\":\"1234567890\",\"expiration_date\":\"2030-01-15\",\"first_name\":\"John\",\"last_name\":\"Doe\",\"middle_name\":\"Michael\",\"date_of_birth\":\"1990-01-15\",\"rapidid_verification_requested_at\":null,\"rapidid_verified_at\":null,\"rapidid_failed_at\":null,\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-15T10:30:00Z\"}}", "name": "Driver license created\/updated successfully" } ] }, { "name": "Get user driver license", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/driver-license", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/driver-license", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves the driver license information for the specified user." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"state_issued\":\"NSW\",\"license_number\":\"12345678\",\"card_number\":\"1234567890\",\"expiration_date\":\"2030-01-15\",\"first_name\":\"John\",\"last_name\":\"Doe\",\"middle_name\":\"Michael\",\"date_of_birth\":\"1990-01-15\",\"rapidid_verification_requested_at\":null,\"rapidid_verified_at\":null,\"rapidid_failed_at\":null,\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-15T10:30:00Z\"}}", "name": "Driver license retrieved successfully" }, { "header": [], "code": 404, "body": "{\"error\":\"Driver license not found for this user.\"}", "name": "Driver license not found" } ] }, { "name": "Delete user driver license", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/driver-license", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/driver-license", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Deletes the driver license record for the specified user." }, "response": [ { "header": [], "code": 204, "body": "[]", "name": "Driver license deleted successfully" }, { "header": [], "code": 404, "body": "{\"error\":\"Driver license not found for this user.\"}", "name": "Driver license not found" } ] }, { "name": "Create or update user immigration card", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/immigration-card", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/immigration-card", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"given_name\":\"John\",\"family_name\":\"Doe\",\"card_number\":\"IMM123456\",\"expiration_date\":\"2030-01-15\",\"card_type\":\"ams\",\"vevo_check_given_name\":\"John\",\"vevo_check_family_name\":\"Doe\",\"vevo_check_passport_number\":\"N1234567\",\"vevo_check_country_of_issue\":\"Australia\"}" }, "description": "Creates a new immigration card record for the user or updates an existing one. Only one immigration card per user is allowed." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"given_name\":\"John\",\"family_name\":\"Doe\",\"card_number\":\"IMM123456\",\"expiration_date\":\"2030-01-15\",\"card_type\":\"ams\",\"vevo_check_given_name\":\"John\",\"vevo_check_family_name\":\"Doe\",\"vevo_check_passport_number\":\"N1234567\",\"vevo_check_country_of_issue\":\"Australia\",\"rapidid_verification_requested_at\":null,\"rapidid_verified_at\":null,\"rapidid_failed_at\":null,\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-15T10:30:00Z\"}}", "name": "Immigration card created\/updated successfully" } ] }, { "name": "Get user immigration card", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/immigration-card", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/immigration-card", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves the immigration card information for the specified user." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"given_name\":\"John\",\"family_name\":\"Doe\",\"card_number\":\"IMM123456\",\"expiration_date\":\"2030-01-15\",\"card_type\":\"ams\",\"vevo_check_given_name\":\"John\",\"vevo_check_family_name\":\"Doe\",\"vevo_check_passport_number\":\"N1234567\",\"vevo_check_country_of_issue\":\"Australia\",\"rapidid_verification_requested_at\":null,\"rapidid_verified_at\":null,\"rapidid_failed_at\":null,\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-15T10:30:00Z\"}}", "name": "Immigration card retrieved successfully" }, { "header": [], "code": 404, "body": "{\"error\":\"Immigration card not found for this user.\"}", "name": "Immigration card not found" } ] }, { "name": "Delete user immigration card", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/immigration-card", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/immigration-card", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Deletes the immigration card record for the specified user." }, "response": [ { "header": [], "code": 204, "body": "[]", "name": "Immigration card deleted successfully" }, { "header": [], "code": 404, "body": "{\"error\":\"Immigration card not found for this user.\"}", "name": "Immigration card not found" } ] }, { "name": "Create or update user Centrelink card", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/centrelink-card", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/centrelink-card", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"crn\":\"123456789A\",\"name_on_card\":\"John Doe\",\"expiration_date\":\"2030-01-15\",\"card_type\":\"hcc\"}" }, "description": "Creates a new Centrelink card record for the user or updates an existing one. Only one Centrelink card per user is allowed." }, "response": [ { "header": [], "code": 201, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"crn\":\"123456789A\",\"name_on_card\":\"John Doe\",\"expiration_date\":\"2030-01-15\",\"card_type\":\"hcc\",\"rapidid_verification_requested_at\":null,\"rapidid_verified_at\":null,\"rapidid_failed_at\":null,\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-15T10:30:00Z\"}}", "name": "Centrelink card created\/updated successfully" } ] }, { "name": "Get user Centrelink card", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/centrelink-card", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/centrelink-card", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieves the Centrelink card information for the specified user." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"crn\":\"123456789A\",\"name_on_card\":\"John Doe\",\"expiration_date\":\"2030-01-15\",\"card_type\":\"hcc\",\"rapidid_verification_requested_at\":null,\"rapidid_verified_at\":null,\"rapidid_failed_at\":null,\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-15T10:30:00Z\"}}", "name": "Centrelink card retrieved successfully" }, { "header": [], "code": 404, "body": "{\"error\":\"Centrelink card not found for this user.\"}", "name": "Centrelink card not found" } ] }, { "name": "Delete user Centrelink card", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/centrelink-card", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/centrelink-card", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Deletes the Centrelink card record for the specified user." }, "response": [ { "header": [], "code": 204, "body": "[]", "name": "Centrelink card deleted successfully" }, { "header": [], "code": 404, "body": "{\"error\":\"Centrelink card not found for this user.\"}", "name": "Centrelink card not found" } ] } ] }, { "name": "User PayTo Agreement Management", "description": "Manage User PayTo Agreements", "item": [ { "name": "Get PayTo agreement status", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/payto-agreement", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/payto-agreement", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns the current PayTo agreement status and details for a user." }, "response": [ { "header": [], "code": 200, "body": "{\"has_agreement\":true,\"agreement_id\":\"PA-123456\",\"maximum_amount\":10000,\"status\":\"ACTIVE\"}", "name": "PayTo agreement found" }, { "header": [], "code": 200, "body": "{\"has_agreement\":false,\"agreement_id\":null,\"maximum_amount\":null,\"status\":null}", "name": "No PayTo agreement" } ] }, { "name": "Create PayTo agreement", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/users\/:user_id\/payto-agreement", "query": [], "raw": "{{baseUrl}}\/api\/v1\/users\/:user_id\/payto-agreement", "variable": [ { "id": "user_id", "key": "user_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The user UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"maximum_amount\":5000,\"pay_id\":\"john@example.com\",\"pay_id_type\":\"EMAIL\",\"account_name\":\"John Doe\",\"account_number\":\"12345678\",\"bsb\":\"123456\"}" }, "description": "Creates a new PayTo agreement for the user. The user must authorize the agreement in their banking app." }, "response": [ { "header": [], "code": 201, "body": "{\"agreement_id\":\"PA-123456\",\"status\":\"CREATED\",\"message\":\"PayTo agreement created. User must authorize in their banking app.\"}", "name": "PayTo agreement created" } ] } ] }, { "name": "Webhook Management", "description": "Manage webhook subscriptions for transaction events", "item": [ { "name": "List webhooks", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/webhooks", "query": [], "raw": "{{baseUrl}}\/api\/v1\/webhooks" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns all registered webhooks for the authenticated partner." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"url\":\"https:\\\/\\\/partner.com\\\/webhooks\\\/goescrow\",\"events\":[\"transaction.created\",\"transaction.clearance_pending\",\"transaction.funded\",\"transaction.status_changed\",\"transaction.funding_status_changed\"],\"is_active\":true,\"last_triggered_at\":\"2024-01-15T10:30:00Z\",\"failure_count\":0,\"created_at\":\"2024-01-01T00:00:00Z\"}]}", "name": "List of webhooks" } ] }, { "name": "Register webhook", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/webhooks", "query": [], "raw": "{{baseUrl}}\/api\/v1\/webhooks" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"url\":\"https:\\\/\\\/partner.com\\\/webhooks\\\/goescrow\",\"events\":[\"transaction.created\",\"beneficiary.confirmation_requested\",\"beneficiary.confirmed\",\"beneficiary.declined\"]}" }, "description": "Registers a new webhook URL to receive transaction event notifications. Available events: transaction.created (when a transaction is created), transaction.clearance_pending (when inbound funding is held for clearance), transaction.funded (when a transaction is funded), transaction.status_changed (when transaction status changes), transaction.funding_status_changed (when transaction funding status changes), transaction.completed (when a transaction is completed\/settled), beneficiary.confirmation_requested (when beneficiary confirmation is requested), beneficiary.confirmed (when a beneficiary confirms receipt), beneficiary.declined (when a beneficiary reports non-receipt)." }, "response": [ { "header": [], "code": 201, "body": "{\"message\":\"Webhook registered successfully.\",\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"url\":\"https:\\\/\\\/partner.com\\\/webhooks\\\/goescrow\",\"secret\":\"whsec_abc123xyz789...\",\"events\":[\"transaction.created\",\"transaction.clearance_pending\"]}", "name": "Webhook registered" } ] }, { "name": "Delete webhook", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/webhooks\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/webhooks\/:id", "variable": [ { "id": "webhook", "key": "webhook", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The webhook ID" } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Unregisters a webhook." }, "response": [ { "header": [], "code": 200, "body": "{\"message\":\"Webhook deleted successfully.\"}", "name": "Webhook deleted" }, { "header": [], "code": 404, "body": "{\"message\":\"Webhook not found.\"}", "name": "Webhook not found" } ] }, { "name": "List webhook deliveries", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/webhooks\/:webhook_id\/deliveries", "query": [], "raw": "{{baseUrl}}\/api\/v1\/webhooks\/:webhook_id\/deliveries", "variable": [ { "id": "webhook", "key": "webhook", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The webhook ID" } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns the delivery history for a webhook (most recent first), so missed events can be inspected and replayed after an outage. Each delivery records the event, the exact payload that was (or will be) sent, the number of attempts, and the last response status." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":[{\"id\":\"9f1b2c3d-4567-89ab-cdef-0123456789ab\",\"event\":\"transaction.funded\",\"status\":\"failed\",\"attempts\":3,\"response_status\":500,\"last_attempted_at\":\"2024-01-15T10:32:00Z\",\"delivered_at\":null,\"created_at\":\"2024-01-15T10:30:00Z\",\"payload\":{\"transaction_id\":\"...\",\"status\":\"pending\"}}],\"meta\":{\"current_page\":1,\"last_page\":1,\"per_page\":50,\"total\":1}}", "name": "List of deliveries" } ] }, { "name": "Redeliver a webhook event", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/webhooks\/:webhook_id\/deliveries\/:delivery_id\/redeliver", "query": [], "raw": "{{baseUrl}}\/api\/v1\/webhooks\/:webhook_id\/deliveries\/:delivery_id\/redeliver", "variable": [ { "id": "webhook", "key": "webhook", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The webhook ID" }, { "id": "delivery", "key": "delivery", "value": "9f1b2c3d-4567-89ab-cdef-0123456789ab", "description": "The delivery ID to redeliver" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Queues a fresh delivery attempt for a past event, using the original payload. Use this to backfill events your endpoint missed during an outage. A new delivery record is created (with a new id) so the original attempt history is preserved." }, "response": [ { "header": [], "code": 202, "body": "{\"message\":\"Webhook delivery has been queued for redelivery.\",\"id\":\"a1b2c3d4-5678-90ab-cdef-1234567890ab\",\"event\":\"transaction.funded\",\"status\":\"pending\"}", "name": "Redelivery queued" }, { "header": [], "code": 404, "body": "{\"message\":\"Delivery not found.\"}", "name": "Delivery not found" }, { "header": [], "code": 409, "body": "{\"message\":\"This delivery is still in progress; wait for it to finish before redelivering.\"}", "name": "Webhook inactive, or delivery still in progress" } ] } ] }, { "name": "Company Bank Account Management", "description": "Manage company bank accounts using Confirmation of Payee", "item": [ { "name": "Update company bank account", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/companies\/:company_id\/bank-account", "query": [], "raw": "{{baseUrl}}\/api\/v1\/companies\/:company_id\/bank-account", "variable": [ { "id": "company_id", "key": "company_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The company UUID (36-character internal identifier)" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"bsb_number\":\"123456\",\"account_number\":\"12345678\",\"account_name\":\"Acme Corp Pty Ltd\"}" }, "description": "Updates company bank details and runs Confirmation of Payee checks against the company's active known names." }, "response": [ { "header": [], "code": 200, "body": "{\"message\":\"Company bank account updated successfully.\",\"is_verified\":true}", "name": "Company bank account updated" } ] }, { "name": "Re-check company bank account", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/companies\/:company_id\/bank-account\/verify", "query": [], "raw": "{{baseUrl}}\/api\/v1\/companies\/:company_id\/bank-account\/verify", "variable": [ { "id": "company_id", "key": "company_id", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The company UUID (36-character internal identifier)" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Re-runs Confirmation of Payee against the company's existing bank details. This is not payout-code verification." }, "response": [ { "header": [], "code": 200, "body": "{\"message\":\"Company bank account check completed.\",\"is_verified\":true}", "name": "Confirmation of Payee re-check completed" } ] } ] }, { "name": "Hosted Login", "description": "Create an identity-only hosted login session, send the user to the returned GoEscrow URL, receive a one-time code at the registered redirect URL, then verify the code server-to-server. The redirect URL is configured by GoEscrow and snapshotted when the session is created.", "item": [ { "name": "Create a hosted login session", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/login-sessions", "query": [], "raw": "{{baseUrl}}\/api\/v1\/login-sessions" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"email\":\"jane@example.com\",\"reference\":\"order-8812\"}" }, "description": "Creates a short-lived hosted login session. Open the returned `url` in the user's browser. After the user signs in and confirms, GoEscrow redirects to the partner's registered URL with `session_id`, `code`, and the optional `reference` query parameters.\n\n```bash\ncurl -X POST 'https:\/\/partner-api.goescrow.com.au\/api\/v1\/login-sessions' \\\n -H 'X-Api-Key: YOUR_API_KEY' \\\n -H 'Content-Type: application\/json' \\\n -d '{\"email\":\"jane@example.com\",\"reference\":\"order-8812\"}'\n```" }, "response": [ { "header": [], "code": 201, "body": "{\"data\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"url\":\"https:\\\/\\\/app.goescrow.com.au\\\/partner-login\\\/plaintext-session-token\",\"expires_at\":\"2026-08-31T04:15:00.000000Z\",\"reference\":\"order-8812\"}}", "name": "Hosted login session created" }, { "header": [], "code": 422, "body": "{\"message\":\"Hosted login is not configured for this partner. Contact GoEscrow to register a redirect URL.\"}", "name": "No redirect URL is registered" } ] }, { "name": "Verify a hosted login code", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/login-sessions\/:loginSession\/verify", "query": [], "raw": "{{baseUrl}}\/api\/v1\/login-sessions\/:loginSession\/verify", "variable": [ { "id": "loginSession", "key": "loginSession", "value": "9d2e5c8a-1234-5678-9abc-def012345678", "description": "The hosted login session UUID returned during creation." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"code\":\"CODE_FROM_REDIRECT\"}" }, "description": "Redeems the one-time code delivered to the registered redirect URL. Verification must use the same partner API key that created the session and must occur before the code expires.\n\n```bash\ncurl -X POST 'https:\/\/partner-api.goescrow.com.au\/api\/v1\/login-sessions\/9d2e5c8a-1234-5678-9abc-def012345678\/verify' \\\n -H 'X-Api-Key: YOUR_API_KEY' \\\n -H 'Content-Type: application\/json' \\\n -d '{\"code\":\"CODE_FROM_REDIRECT\"}'\n```" }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"user\":{\"id\":\"9d2e5c8a-1234-5678-9abc-def012345678\",\"reference\":\"ABC123\",\"first_name\":\"Jane\",\"last_name\":\"Doe\",\"email\":\"jane@example.com\",\"phone\":\"+61412345678\",\"birth_date\":\"1990-01-15\",\"kyc_verified\":true,\"aml_verified\":true,\"aml_verified_at\":\"2026-08-20T00:00:00.000000Z\",\"email_verified\":true,\"mobile_verified\":true,\"mobilekyc_verified\":true,\"bank_verified\":true,\"suspended\":false,\"address\":null},\"reference\":\"order-8812\",\"authenticated_at\":\"2026-08-31T04:01:00.000000Z\"}}", "name": "Login code verified" }, { "header": [], "code": 404, "body": "{\"message\":\"Not Found\"}", "name": "The session does not exist for this partner" }, { "header": [], "code": 422, "body": "{\"message\":\"Invalid or expired login code.\"}", "name": "The code is wrong, expired, already redeemed, or the session is not authenticated" } ] } ] } ], "auth": { "type": "apikey", "apikey": [ { "key": "in", "value": "header", "type": "string" }, { "key": "key", "value": "X-API-Key", "type": "string" } ] } }