Send an own-wallet P2P transfer

POST

payments

p2p

own

curl --request POST \
  --url https://api.zeam.money/gw/v1/payments/p2p/own \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-zeam-auth: <api-key>' \
  --data '
{
  "transactionId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "walletId": "66666666-6666-6666-6666-666666666666",
  "destinationWalletId": "99999999-9999-9999-9999-999999999999",
  "sendingAssetCode": "USDZ",
  "amount": 25.5
}
'

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

{
  "type": "https://errors.zeam.app/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The 'amount' field must be a positive decimal.",
  "instance": "/v1/quotes",
  "requestId": "01J8Z6K3QW9F2",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "https://errors.zeam.app/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The 'amount' field must be a positive decimal.",
  "instance": "/v1/quotes",
  "requestId": "01J8Z6K3QW9F2",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "https://errors.zeam.app/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The 'amount' field must be a positive decimal.",
  "instance": "/v1/quotes",
  "requestId": "01J8Z6K3QW9F2",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "https://errors.zeam.app/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The 'amount' field must be a positive decimal.",
  "instance": "/v1/quotes",
  "requestId": "01J8Z6K3QW9F2",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "https://errors.zeam.app/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The 'amount' field must be a positive decimal.",
  "instance": "/v1/quotes",
  "requestId": "01J8Z6K3QW9F2",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "https://errors.zeam.app/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The 'amount' field must be a positive decimal.",
  "instance": "/v1/quotes",
  "requestId": "01J8Z6K3QW9F2",
  "errors": [
    {
      "field": "<string>",
      "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

Same-asset transfer between two of the caller's own wallets. Beneficiary fields are not accepted; use POST /v1/payments/p2p/beneficiary instead. transactionId is the only identity field — it is the idempotency key and the reference recorded on the transaction.

transactionId

string<uuid>

required

Your transaction id. Replaying it returns the original result.

walletId

string<uuid>

required

Source wallet.

destinationWalletId

string<uuid>

required

Destination wallet in your own association.

sendingAssetCode

string

required

Asset to send — bare code (e.g. USDZ). The gateway resolves the issuer from the asset registry.

Example:

"USDZ"

amount

number

required

Amount to send, denominated in sendingAssetCode.

memo

string

Optional Stellar memo.

fromRef

string | null

Optional sender-side transaction reference, shown on the sender's statement. When supplied: 1-16 characters, letters, digits, and hyphens only. Omit it or send null for no reference.

Maximum string length: 16

Pattern: ^[A-Za-z0-9-]{1,16}$

toRef

string | null

Optional recipient-side transaction reference, shown on the recipient's statement (for withdrawals it is also printed on their bank or mobile-money statement). When supplied: 1-16 characters, letters, digits, and hyphens only. Omit it or send null for no reference.

Maximum string length: 16

Pattern: ^[A-Za-z0-9-]{1,16}$

Response

Payment 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

Send an own-wallet P2P transfer

curl --request POST \
  --url https://api.zeam.money/gw/v1/payments/p2p/own \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-zeam-auth: <api-key>' \
  --data '
{
  "transactionId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "walletId": "66666666-6666-6666-6666-666666666666",
  "destinationWalletId": "99999999-9999-9999-9999-999999999999",
  "sendingAssetCode": "USDZ",
  "amount": 25.5
}
'

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

{
  "type": "https://errors.zeam.app/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The 'amount' field must be a positive decimal.",
  "instance": "/v1/quotes",
  "requestId": "01J8Z6K3QW9F2",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "https://errors.zeam.app/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The 'amount' field must be a positive decimal.",
  "instance": "/v1/quotes",
  "requestId": "01J8Z6K3QW9F2",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "https://errors.zeam.app/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The 'amount' field must be a positive decimal.",
  "instance": "/v1/quotes",
  "requestId": "01J8Z6K3QW9F2",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "https://errors.zeam.app/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The 'amount' field must be a positive decimal.",
  "instance": "/v1/quotes",
  "requestId": "01J8Z6K3QW9F2",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "https://errors.zeam.app/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The 'amount' field must be a positive decimal.",
  "instance": "/v1/quotes",
  "requestId": "01J8Z6K3QW9F2",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "https://errors.zeam.app/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The 'amount' field must be a positive decimal.",
  "instance": "/v1/quotes",
  "requestId": "01J8Z6K3QW9F2",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

Overview

Auth

Wallets

Assets

Beneficiaries

Connectors

Quotes

Payments

Transactions

Statements

Webhooks

Send an own-wallet P2P transfer

Authorizations

Body

Response