POST/escrow/new-account
Create New Account
Creates a new escrow account
Signature: Required
Request Headers
auth
Your API Key
x-payload-signature
HMACSHA256(JSON.stringify(request body), secretKey)
Mandatory Body
| Key | Type | Description |
|---|---|---|
| escrowUseCase | string | Allowed values: "eoisale", "eoirental", "rentalsecurity", "saleadv", "rentcol" |
| description | string | A brief description of the escrow account |
| secondParties | Array | Non-empty array. Each party requires countryCode, phone, email, firstName, lastName, panNumber |
| propertyAddress | Object | Requires addressLine1, city, state, pincode. addressLine2 is optional |
| externalRef | string | Unique external reference for this escrow account. Duplicate values are rejected |
Optional Body
| Key | Type | Description |
|---|---|---|
| callbackUrl | string | Webhook URL for escrow account and deposit updates |
| tokenAmount | number | Initial UPI intent amount. Must be between 0 and 100000 |
| dateDue | string | ISO 8601 due date. Allowed only when tokenAmount is present and greater than 0, and must be at least 1 hour in the future |
| method | "async" | "sync" | Defaults to "async". Use "sync" to wait up to 60 seconds for account details and optional payment details |
| firstParties | Array | Optional non-empty array. Each party requires countryCode, phone, email, firstName, lastName |
| sellers | Array | Optional non-empty array. Each seller requires countryCode, phone, email, firstName, lastName |
| stakeholders | Array | Optional array of registered stakeholders. Each stakeholder requires email |
Behavior Notes
- secondParties cannot overlap with firstParties, sellers, stakeholders, ownership admins, or the creator.
Sample Request
{
"escrowUseCase": "eoisale",
"description": "For Brigade Metropolis",
"secondParties": [
{
"countryCode": "91",
"phone": "9999999999",
"email": "buyer@example.com",
"firstName": "Mayank",
"lastName": "Jain",
"panNumber": "AAAAA1234A"
}
],
"propertyAddress": {
"addressLine1": "Tower A, Brigade Metropolis",
"addressLine2": "Whitefield",
"city": "Bengaluru",
"state": "Karnataka",
"pincode": "560097"
},
"callbackUrl": "https://yourapp.com/webhooks/escrow",
"externalRef": "BOOKING-1001",
"tokenAmount": 50000,
"dateDue": "2026-05-08T13:00:00.000Z",
"method": "sync"
}Sample Responses
Async Response
{
"result": "success"
}Sync Response
{
"accountNum": "RLTM250773061550",
"accountName": "Realtimate Labs",
"ifscCode": "ICIC000123",
"bankName": "ICICI Bank",
"accountType": "Current",
"externalRef": "BOOKING-1001",
"paymentIntent": "upi://pay?pa=REALTIMATE@icici&pn=Realtimate Labs&tr=REF123&am=50000&cu=INR&mc=5411",
"paymentLink": "https://pay.realtimate.in/p/abc123",
"dateDue": "2026-05-08T13:00:00.000Z",
"amount": "50000"
}