Send multiple own-wallet P2P transfers atomically

Submits multiple same-asset transfers between your own wallets as one atomic Stellar transaction. All legs settle or fail together under a single transaction record, intent, and webhook lifecycle. Returns 202.

POST /payments/p2p/own/multi

Send multiple own-wallet P2P transfers atomically

cURL

curl --request POST \
  --url https://api.zeam.money/gw/v1/payments/p2p/own/multi \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-zeam-auth: <api-key>' \
  --data '
{
  "transactionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "transfers": [
    {
      "walletId": "66666666-6666-6666-6666-666666666666",
      "destinationWalletId": "99999999-9999-9999-9999-999999999999",
      "sendingAssetCode": "USDZ",
      "amount": 10
    },
    {
      "walletId": "66666666-6666-6666-6666-666666666666",
      "destinationWalletId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "sendingAssetCode": "USDZ",
      "amount": 15
    }
  ]
}
'

202

{
  "transactionRecordId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "accepted",
  "intentId": "<string>",
  "isIdempotent": true,
  "message": "<string>"
}

Authorizations

Authorization · string · header · required

Access token issued by POST /v1/auth/token.

x-zeam-auth · string · header · required

Application secret (the apiKey issued at registration), required on every request.

Body

application/json

Multiple same-asset transfers between the caller's own wallets, executed as one atomic Stellar transaction. transactionId is the only identity field.

transactionId · string<uuid> · required

Your transaction id. Replaying it returns the original result.

transfers · object[] · required

Transfer legs. All legs settle or fail together.

Show child attributes

memo · string

Optional Stellar memo (applies to the whole transaction).

Response

202

application/json

Multi-transfer accepted for asynchronous processing.

A 202 means the submission was accepted for asynchronous execution, not that it settled. Track completion with the Transactions routes or webhooks.

transactionRecordId · string<uuid> · required

The transaction record id, used with GET /v1/transactions/{transactionId}.

status · string · required

Submission status; not a terminal transaction status.

Example:

"accepted"

intentId · string

Execution intent id, when present.

isIdempotent · boolean

True when this response replays a prior submission with the same transactionId.

message · string