Transfer funds between sellers

• Sandbox: POST https://sandbox.payme.io/api/sales
• Production: POST https://live.payme.io/api/sales

Credentials

• Request body field seller_payme_id (required): The MPL of the seller that receives the funds. It also authenticates the call.
• Request body field payme_client_key (optional): Partners: your client key. Both sellers must belong to this partner.

Moves funds from one seller's PayMe balance (payment.origin_seller_id) to another seller's (seller_payme_id). PayMe records the transfer as a completed sale on the receiving seller, with sale_payment_method funds-transfer. Amounts are in minor units (1000 = 10.00).

• Authentication: seller_payme_id, the receiving seller's MPL, authenticates the call. Partners also send payme_client_key.
• Same partner, different accounts: both sellers must belong to the same partner, and they must be two different accounts (error 20).
• Services: the origin seller needs the funds-transfer service and the receiving seller the funds-transfer Destination service (error 720). To enable them, ask partners@payme.io and give both MPLs.
• Validated origin: the origin seller's account must be validated (error 109).
• A failed transfer still returns HTTP 200, with status_code 1, payme_status error and the reason in status_error_code and status_error_details. Check status_code, not only the HTTP status.

Errors

Parameters

This endpoint takes no path, query or header parameters.

Request body

Content type: application/json

Request example

{
  "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-7654321",
  "sale_price": 15000,
  "currency": "ILS",
  "product_name": "Monthly settlement",
  "payment": {
    "method": "funds-transfer",
    "origin_seller_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567"
  }
}

Code samples

curl

curl -X POST 'https://sandbox.payme.io/api/sales' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-7654321",
  "sale_price": 15000,
  "currency": "ILS",
  "product_name": "Monthly settlement",
  "payment": {
    "method": "funds-transfer",
    "origin_seller_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567"
  }
}'

Node.js

const response = await fetch("https://sandbox.payme.io/api/sales", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-7654321",
    "sale_price": 15000,
    "currency": "ILS",
    "product_name": "Monthly settlement",
    "payment": {
      "method": "funds-transfer",
      "origin_seller_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567"
    }
  }),
});

console.log(await response.text());

Python

import requests

response = requests.post(
    "https://sandbox.payme.io/api/sales",
    json={
        "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-7654321",
        "sale_price": 15000,
        "currency": "ILS",
        "product_name": "Monthly settlement",
        "payment": {
            "method": "funds-transfer",
            "origin_seller_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567",
        },
    },
)

print(response.text)

PHP

<?php

$body = <<<'BODY'
{
  "seller_payme_id": "MPLDEMO-MPLDEMO-MPLDEMO-7654321",
  "sale_price": 15000,
  "currency": "ILS",
  "product_name": "Monthly settlement",
  "payment": {
    "method": "funds-transfer",
    "origin_seller_id": "MPLDEMO-MPLDEMO-MPLDEMO-1234567"
  }
}
BODY;

$ch = curl_init('https://sandbox.payme.io/api/sales');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $body,
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Responses

200 — The transfer result, as a sale on the receiving seller. The response also carries the other fields of a sale response, such as buyer_*, payme_transaction_card_brand and installments. They describe card sales; don't rely on them for a transfer. (success)

{
  "status_code": 0,
  "payme_status": "success",
  "status_error_code": 0,
  "payme_sale_id": "SALE1700-000000AA-EXAMPLE1-SALE0001",
  "payme_sale_code": 8965519,
  "sale_created": "2026-11-09 16:28:08",
  "sale_status": "completed",
  "payme_sale_status": "completed",
  "sale_payment_method": "funds-transfer",
  "currency": "ILS",
  "price": 15000,
  "sale_description": "Monthly settlement",
  "payme_signature": "9c1d6f0e2b7a4c3d8e5f6a7b8c9d0e1f",
  "payme_transaction_id": "TRAN1700-000000AA-EXAMPLE1-TXN00001",
  "payme_transaction_total": 15000,
  "sale_paid_date": "2026-11-09 16:28:08",
  "sale_release_date": "2026-11-09 16:28:09",
  "session": "FhT3aXe7"
}

400 — A missing product_name, a currency the receiving seller can't use, or an origin seller that isn't validated. (error)

{
  "status_code": 1,
  "status_error_details": "Invalid description",
  "status_additional_info": "product_name",
  "status_error_code": 353,
  "session": "FhT3aXe7"
}

500 — A missing field or key, sellers that can't transfer to each other, or a service that isn't enabled. (error)

{
  "status_code": 1,
  "status_error_details": "The service was not activated",
  "status_additional_info": "funds-transfer",
  "status_error_code": 720,
  "session": "FhT3aXe7"
}