Notify deposit from partner (async)

curl --request POST \
  --url https://public-api.etoro.com/api/v1/money/deposit/notify \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-user-key: <api-key>' \
  --data '
{
  "accountId": "ACC-14540678",
  "transactionId": "TXN-4783212",
  "transactionDate": "2025-09-14T10:05:08Z",
  "inputAmount": {
    "amount": 850,
    "currency": "EUR"
  },
  "convertedAmount": {
    "amount": 1000,
    "currency": "USD"
  },
  "externalTransactionId": "STRIPE-4e7dc7ff246b44af9907",
  "paymentMethodType": "ach",
  "depositType": "regular",
  "extraData": {}
}
'

import requests

url = "https://public-api.etoro.com/api/v1/money/deposit/notify"

payload = {
    "accountId": "ACC-14540678",
    "transactionId": "TXN-4783212",
    "transactionDate": "2025-09-14T10:05:08Z",
    "inputAmount": {
        "amount": 850,
        "currency": "EUR"
    },
    "convertedAmount": {
        "amount": 1000,
        "currency": "USD"
    },
    "externalTransactionId": "STRIPE-4e7dc7ff246b44af9907",
    "paymentMethodType": "ach",
    "depositType": "regular",
    "extraData": {}
}
headers = {
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    accountId: 'ACC-14540678',
    transactionId: 'TXN-4783212',
    transactionDate: '2025-09-14T10:05:08Z',
    inputAmount: {amount: 850, currency: 'EUR'},
    convertedAmount: {amount: 1000, currency: 'USD'},
    externalTransactionId: 'STRIPE-4e7dc7ff246b44af9907',
    paymentMethodType: 'ach',
    depositType: 'regular',
    extraData: {}
  })
};

fetch('https://public-api.etoro.com/api/v1/money/deposit/notify', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v1/money/deposit/notify",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'accountId' => 'ACC-14540678',
    'transactionId' => 'TXN-4783212',
    'transactionDate' => '2025-09-14T10:05:08Z',
    'inputAmount' => [
        'amount' => 850,
        'currency' => 'EUR'
    ],
    'convertedAmount' => [
        'amount' => 1000,
        'currency' => 'USD'
    ],
    'externalTransactionId' => 'STRIPE-4e7dc7ff246b44af9907',
    'paymentMethodType' => 'ach',
    'depositType' => 'regular',
    'extraData' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>",
    "x-user-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v1/money/deposit/notify"

	payload := strings.NewReader("{\n  \"accountId\": \"ACC-14540678\",\n  \"transactionId\": \"TXN-4783212\",\n  \"transactionDate\": \"2025-09-14T10:05:08Z\",\n  \"inputAmount\": {\n    \"amount\": 850,\n    \"currency\": \"EUR\"\n  },\n  \"convertedAmount\": {\n    \"amount\": 1000,\n    \"currency\": \"USD\"\n  },\n  \"externalTransactionId\": \"STRIPE-4e7dc7ff246b44af9907\",\n  \"paymentMethodType\": \"ach\",\n  \"depositType\": \"regular\",\n  \"extraData\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-user-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://public-api.etoro.com/api/v1/money/deposit/notify")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"accountId\": \"ACC-14540678\",\n  \"transactionId\": \"TXN-4783212\",\n  \"transactionDate\": \"2025-09-14T10:05:08Z\",\n  \"inputAmount\": {\n    \"amount\": 850,\n    \"currency\": \"EUR\"\n  },\n  \"convertedAmount\": {\n    \"amount\": 1000,\n    \"currency\": \"USD\"\n  },\n  \"externalTransactionId\": \"STRIPE-4e7dc7ff246b44af9907\",\n  \"paymentMethodType\": \"ach\",\n  \"depositType\": \"regular\",\n  \"extraData\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/money/deposit/notify")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"accountId\": \"ACC-14540678\",\n  \"transactionId\": \"TXN-4783212\",\n  \"transactionDate\": \"2025-09-14T10:05:08Z\",\n  \"inputAmount\": {\n    \"amount\": 850,\n    \"currency\": \"EUR\"\n  },\n  \"convertedAmount\": {\n    \"amount\": 1000,\n    \"currency\": \"USD\"\n  },\n  \"externalTransactionId\": \"STRIPE-4e7dc7ff246b44af9907\",\n  \"paymentMethodType\": \"ach\",\n  \"depositType\": \"regular\",\n  \"extraData\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "transactionId": "TXN-4783212",
    "message": "Deposit notification accepted for processing"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "<string>",
    "details": "<string>",
    "field": "<string>"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "<string>",
    "details": "<string>",
    "field": "<string>"
  }
}

POST

api

money

deposit

notify

Notify deposit from partner (async)

curl --request POST \
  --url https://public-api.etoro.com/api/v1/money/deposit/notify \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-user-key: <api-key>' \
  --data '
{
  "accountId": "ACC-14540678",
  "transactionId": "TXN-4783212",
  "transactionDate": "2025-09-14T10:05:08Z",
  "inputAmount": {
    "amount": 850,
    "currency": "EUR"
  },
  "convertedAmount": {
    "amount": 1000,
    "currency": "USD"
  },
  "externalTransactionId": "STRIPE-4e7dc7ff246b44af9907",
  "paymentMethodType": "ach",
  "depositType": "regular",
  "extraData": {}
}
'

import requests

url = "https://public-api.etoro.com/api/v1/money/deposit/notify"

payload = {
    "accountId": "ACC-14540678",
    "transactionId": "TXN-4783212",
    "transactionDate": "2025-09-14T10:05:08Z",
    "inputAmount": {
        "amount": 850,
        "currency": "EUR"
    },
    "convertedAmount": {
        "amount": 1000,
        "currency": "USD"
    },
    "externalTransactionId": "STRIPE-4e7dc7ff246b44af9907",
    "paymentMethodType": "ach",
    "depositType": "regular",
    "extraData": {}
}
headers = {
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    accountId: 'ACC-14540678',
    transactionId: 'TXN-4783212',
    transactionDate: '2025-09-14T10:05:08Z',
    inputAmount: {amount: 850, currency: 'EUR'},
    convertedAmount: {amount: 1000, currency: 'USD'},
    externalTransactionId: 'STRIPE-4e7dc7ff246b44af9907',
    paymentMethodType: 'ach',
    depositType: 'regular',
    extraData: {}
  })
};

fetch('https://public-api.etoro.com/api/v1/money/deposit/notify', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v1/money/deposit/notify",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'accountId' => 'ACC-14540678',
    'transactionId' => 'TXN-4783212',
    'transactionDate' => '2025-09-14T10:05:08Z',
    'inputAmount' => [
        'amount' => 850,
        'currency' => 'EUR'
    ],
    'convertedAmount' => [
        'amount' => 1000,
        'currency' => 'USD'
    ],
    'externalTransactionId' => 'STRIPE-4e7dc7ff246b44af9907',
    'paymentMethodType' => 'ach',
    'depositType' => 'regular',
    'extraData' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>",
    "x-user-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v1/money/deposit/notify"

	payload := strings.NewReader("{\n  \"accountId\": \"ACC-14540678\",\n  \"transactionId\": \"TXN-4783212\",\n  \"transactionDate\": \"2025-09-14T10:05:08Z\",\n  \"inputAmount\": {\n    \"amount\": 850,\n    \"currency\": \"EUR\"\n  },\n  \"convertedAmount\": {\n    \"amount\": 1000,\n    \"currency\": \"USD\"\n  },\n  \"externalTransactionId\": \"STRIPE-4e7dc7ff246b44af9907\",\n  \"paymentMethodType\": \"ach\",\n  \"depositType\": \"regular\",\n  \"extraData\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-user-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://public-api.etoro.com/api/v1/money/deposit/notify")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"accountId\": \"ACC-14540678\",\n  \"transactionId\": \"TXN-4783212\",\n  \"transactionDate\": \"2025-09-14T10:05:08Z\",\n  \"inputAmount\": {\n    \"amount\": 850,\n    \"currency\": \"EUR\"\n  },\n  \"convertedAmount\": {\n    \"amount\": 1000,\n    \"currency\": \"USD\"\n  },\n  \"externalTransactionId\": \"STRIPE-4e7dc7ff246b44af9907\",\n  \"paymentMethodType\": \"ach\",\n  \"depositType\": \"regular\",\n  \"extraData\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/money/deposit/notify")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"accountId\": \"ACC-14540678\",\n  \"transactionId\": \"TXN-4783212\",\n  \"transactionDate\": \"2025-09-14T10:05:08Z\",\n  \"inputAmount\": {\n    \"amount\": 850,\n    \"currency\": \"EUR\"\n  },\n  \"convertedAmount\": {\n    \"amount\": 1000,\n    \"currency\": \"USD\"\n  },\n  \"externalTransactionId\": \"STRIPE-4e7dc7ff246b44af9907\",\n  \"paymentMethodType\": \"ach\",\n  \"depositType\": \"regular\",\n  \"extraData\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "transactionId": "TXN-4783212",
    "message": "Deposit notification accepted for processing"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "<string>",
    "details": "<string>",
    "field": "<string>"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "<string>",
    "details": "<string>",
    "field": "<string>"
  }
}

Authorizations

x-api-key

string

header

default:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

required

API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.

Demo credential for trying the API from these docs: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

x-user-key

string

header

default:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

required

User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.

Demo credential for trying the API from these docs: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

Headers

X-Request-ID

string

Request ID for tracing

Body

application/json

Deposit notification request. The user is identified by the X-User-Key header.

accountId

string

required

Account identifier within the partner system

Example:

"ACC-14540678"

transactionId

string

required

Unique transaction/deposit identifier from partner system

Example:

"TXN-4783212"

transactionDate

string<date-time>

required

Date and time when the deposit was approved (UTC)

Example:

"2025-09-14T10:05:08Z"

inputAmount

object

required

Show child attributes

convertedAmount

object

required

Show child attributes

externalTransactionId

string

Reference ID from external payment provider (optional)

Example:

"STRIPE-4e7dc7ff246b44af9907"

feeAmount

object

Show child attributes

paymentMethodType

enum<string>

Available options:

creditCard,

wireTransfer,

payPal,

bankDraft,

westernUnion,

neteller,

netellerOnePay,

moneyBookers,

moneyGram,

webMoney,

giropay,

elv,

direct24,

payoneer,

sofort,

internalPayment,

localBankWire,

testDeposit,

ibDeposit,

bankDetails,

yandex,

unionPay,

qiwi,

cashU,

aliPay,

weChat,

eToroCryptoWallet,

onlineBanking,

ach,

rapidTransfer,

astroPay,

pwmb,

eToroMoney,

ideal,

trustly,

przelewy24,

poli,

openBanking,

test

Example:

"ach"

depositType

enum<string>

default:regular

Available options:

regular,

recurring

Example:

"regular"

extraData

object

Additional key-value data specific to the partner/account type

Response

Deposit notification accepted (acknowledgment)

success

boolean

Example:

true

data

object

Show child attributes

⌘I

Getting started

Partners API

Changelog

Notify deposit from partner (async)

Authorizations

Headers

Body

Response