Create Batch Transactions
Batch Transactions
POST
https://api.synapsefi.com/v3.1/users/:user_id/nodes/:node_id/batch-trans
This endpoint allows you to create up-to 500 transactions (100 in sandbox) from one node at once.
Path Parameters
Name | Type | Description |
---|---|---|
node_id | string | ID of the node. |
user_id | string | ID of the user. |
Headers
Name | Type | Description |
---|---|---|
X-SP-USER | string | User's OAuth key and device fingerprint, separated by a pipe. |
X-SP-USER-IP | string | IP address of user's device. |
X-SP-GATEWAY | string | Your Client ID and Secret, separated by a pipe. |
Request Body
Name | Type | Description |
---|---|---|
transactions | array | Go to Transaction Object Details to see all the required and optional body parameters allowed during transaction creation |
{
"error_code": "0",
"http_code": "200",
"page_count": 1,
"success": true,
"trans": [
{
"_id": "5f6b96672ecd0aa63709d21e",
"_links": {
"self": {
"href": "https://uat-api.synapsefi.com/v3.1/users/5f6b8ae599c8e5007852a2ed/nodes/5f6b965de079bc5b16ac0d65/trans/5f6b96672ecd0aa63709d21e"
}
},
"_v": 2,
"amount": {
"amount": 34.0,
"currency": "USD"
},
"client": {
"id": "5da6466cf49fd1019aa1f828",
"name": "* Stella Liang"
},
"extra": {
"asset": null,
"created_on": 1600886375194,
"group_id": null,
"ip": "127.0.0.1",
"latlon": "unknown,unknown",
"location": {
"address_city": null,
"address_country_code": null,
"address_postal_code": null,
"address_subdivision": null,
"lat": 0,
"lon": 0
},
"note": "Banking Fees",
"other": {
"affect_limits": true,
"attachments": [],
"chargeback_disputed": false,
"dispute_form": null,
"disputed": false,
"is_provisional_credit": false
},
"process_on": 1600886375194,
"rate": null,
"rate_limit": null,
"same_day": false,
"settlement_delay": 0,
"supp_id": "",
"tracking_number": null
},
"fees": [
{
"fee": 0.0,
"note": "Facilitator Fee",
"to": {
"id": "None"
}
}
],
"from": {
"id": "5f6b965de079bc5b16ac0d65",
"nickname": "SynapsePay Test Checking Account - 8901",
"type": "ACH-US",
"user": {
"_id": "5f6b8ae599c8e5007852a2ed",
"legal_names": [
"Ja To"
]
}
},
"recent_status": {
"date": 1600886375194,
"note": "Transaction Created.",
"status": "CREATED",
"status_id": "1"
},
"timeline": [
{
"date": 1600886375194,
"note": "Transaction Created.",
"status": "CREATED",
"status_id": "1"
}
],
"to": {
"id": "5f69275098021636016189ad",
"nickname": "Pos balance with doc ID",
"type": "DEPOSIT-US",
"user": {
"_id": "5f63dada04707a00550464ba",
"legal_names": [
"Ja To"
]
}
}
},
{
"_id": "5f6b96676fb4a2d20665f479",
"_links": {
"self": {
"href": "https://uat-api.synapsefi.com/v3.1/users/5f6b8ae599c8e5007852a2ed/nodes/5f6b965de079bc5b16ac0d65/trans/5f6b96676fb4a2d20665f479"
}
},
"_v": 2,
"amount": {
"amount": 34.0,
"currency": "USD"
},
"client": {
"id": "5da6466cf49fd1019aa1f828",
"name": "* Stella Liang"
},
"extra": {
"asset": null,
"created_on": 1600886375805,
"group_id": null,
"ip": "127.0.0.1",
"latlon": "unknown,unknown",
"location": {
"address_city": null,
"address_country_code": null,
"address_postal_code": null,
"address_subdivision": null,
"lat": 0,
"lon": 0
},
"note": "Banking Fees",
"other": {
"affect_limits": true,
"attachments": [],
"chargeback_disputed": false,
"dispute_form": null,
"disputed": false,
"is_provisional_credit": false
},
"process_on": 1600886375805,
"rate": null,
"rate_limit": null,
"same_day": false,
"settlement_delay": 0,
"supp_id": "",
"tracking_number": null
},
"fees": [
{
"fee": 0.0,
"note": "Facilitator Fee",
"to": {
"id": "None"
}
}
],
"from": {
"id": "5f6b965de079bc5b16ac0d65",
"nickname": "SynapsePay Test Checking Account - 8901",
"type": "ACH-US",
"user": {
"_id": "5f6b8ae599c8e5007852a2ed",
"legal_names": [
"Ja To"
]
}
},
"recent_status": {
"date": 1600886375805,
"note": "Transaction Created.",
"status": "CREATED",
"status_id": "1"
},
"timeline": [
{
"date": 1600886375805,
"note": "Transaction Created.",
"status": "CREATED",
"status_id": "1"
}
],
"to": {
"id": "5f69275098021636016189ad",
"nickname": "Pos balance with doc ID",
"type": "DEPOSIT-US",
"user": {
"_id": "5f63dada04707a00550464ba",
"legal_names": [
"Ja To"
]
}
}
},
{
"_id": "5f6b96673b5ef95d4a66a0a6",
"_links": {
"self": {
"href": "https://uat-api.synapsefi.com/v3.1/users/5f6b8ae599c8e5007852a2ed/nodes/5f6b965de079bc5b16ac0d65/trans/5f6b96673b5ef95d4a66a0a6"
}
},
"_v": 2,
"amount": {
"amount": 34.0,
"currency": "USD"
},
"client": {
"id": "5da6466cf49fd1019aa1f828",
"name": "* Stella Liang"
},
"extra": {
"asset": null,
"created_on": 1600886375811,
"group_id": null,
"ip": "127.0.0.1",
"latlon": "unknown,unknown",
"location": {
"address_city": null,
"address_country_code": null,
"address_postal_code": null,
"address_subdivision": null,
"lat": 0,
"lon": 0
},
"note": "Banking Fees",
"other": {
"affect_limits": true,
"attachments": [],
"chargeback_disputed": false,
"dispute_form": null,
"disputed": false,
"is_provisional_credit": false
},
"process_on": 1600886375811,
"rate": null,
"rate_limit": null,
"same_day": false,
"settlement_delay": 0,
"supp_id": "",
"tracking_number": null
},
"fees": [
{
"fee": 0.0,
"note": "Facilitator Fee",
"to": {
"id": "None"
}
}
],
"from": {
"id": "5f6b965de079bc5b16ac0d65",
"nickname": "SynapsePay Test Checking Account - 8901",
"type": "ACH-US",
"user": {
"_id": "5f6b8ae599c8e5007852a2ed",
"legal_names": [
"Ja To"
]
}
},
"recent_status": {
"date": 1600886375811,
"note": "Transaction Created.",
"status": "CREATED",
"status_id": "1"
},
"timeline": [
{
"date": 1600886375811,
"note": "Transaction Created.",
"status": "CREATED",
"status_id": "1"
}
],
"to": {
"id": "5f69275098021636016189ad",
"nickname": "Pos balance with doc ID",
"type": "DEPOSIT-US",
"user": {
"_id": "5f63dada04707a00550464ba",
"legal_names": [
"Ja To"
]
}
}
}
],
"trans_count": 3
}
{
"error": {
"code": "missing_user_credentials",
"en": "User credentials are missing from the request."
},
"error_code": "200",
"http_code": "400",
"success": false
}
Node Balance Race Conditions
When creating batch transactions, multiple transactions are processed simultaneously. Please make sure the withdrawal node has sufficient funds to process all of the transactions or the node may be depleted to a negative balance.
Support for Idempotency
To enable idempotency controls per transaction, add extra.idempotency_key
inside each transaction object. Example:
{
"transactions": [
{
"to": {
"type": "DEPOSIT-US",
"id": "5f69275098021636016189ad"
},
"amount": {
"amount": 34,
"currency": "USD"
},
"extra": {
"ip": "127.0.0.1",
"note": "Banking Fees",
"idempotency_key": "testidp1"
}
}
]
}
Example Request
POST /v3.1/users/5fe50a777562960078d3a5c6/nodes/5fe50b2dab6ce7004340c43a/batch-trans HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 255.127.79.76
X-SP-USER: oauth_ohpVj1iwMQgqHR0ATzbGEU4fBuXOJ0FWZk28y7cD|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json
{
"transactions": [
{
"to": {
"type": "DEPOSIT-US",
"id": "5f69275098021636016189ad"
},
"amount": {
"amount": 34,
"currency": "USD"
},
"extra": {
"ip": "127.0.0.1",
"note": "Banking Fees"
}
},
{
"to": {
"type": "DEPOSIT-US",
"id": "5f69275098021636016189ad"
},
"amount": {
"amount": 34,
"currency": "USD"
},
"extra": {
"ip": "127.0.0.1",
"note": "Banking Fees"
}
},
{
"to": {
"type": "DEPOSIT-US",
"id": "5f69275098021636016189ad"
},
"amount": {
"amount": 34,
"currency": "USD"
},
"extra": {
"ip": "127.0.0.1",
"note": "Banking Fees"
}
}
]
}
curl --location --request POST 'https://uat-api.synapsefi.com/v3.1/users/5fe50a777562960078d3a5c6/nodes/5fe50b2dab6ce7004340c43a/batch-trans' \
--header 'X-SP-USER-IP: 255.127.79.76' \
--header 'X-SP-USER: oauth_ohpVj1iwMQgqHR0ATzbGEU4fBuXOJ0FWZk28y7cD|e83cf6ddcf778e37bfe3d48fc78a6502062fc' \
--header 'Content-Type: application/json'
--data-raw '{
"transactions": [
{
"to": {
"type": "DEPOSIT-US",
"id": "5f69275098021636016189ad"
},
"amount": {
"amount": 34,
"currency": "USD"
},
"extra": {
"ip": "127.0.0.1",
"note": "Banking Fees"
}
},
{
"to": {
"type": "DEPOSIT-US",
"id": "5f69275098021636016189ad"
},
"amount": {
"amount": 34,
"currency": "USD"
},
"extra": {
"ip": "127.0.0.1",
"note": "Banking Fees"
}
},
{
"to": {
"type": "DEPOSIT-US",
"id": "5f69275098021636016189ad"
},
"amount": {
"amount": 34,
"currency": "USD"
},
"extra": {
"ip": "127.0.0.1",
"note": "Banking Fees"
}
}
]
}'
//
//
//
//
Last updated