curl --request PUT \
--url https://mart.ps/api/v1/payout-method \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"iban": "PS92 PALS 0000 0000 0400 1234 5670 2",
"account_holder_name": "Al Noor Shop",
"national_id": "123456789"
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
iban: 'PS92 PALS 0000 0000 0400 1234 5670 2',
account_holder_name: 'Al Noor Shop',
national_id: '123456789'
})
};
fetch('https://mart.ps/api/v1/payout-method', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://mart.ps/api/v1/payout-method"
payload = {
"iban": "PS92 PALS 0000 0000 0400 1234 5670 2",
"account_holder_name": "Al Noor Shop",
"national_id": "123456789"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mart.ps/api/v1/payout-method",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'iban' => 'PS92 PALS 0000 0000 0400 1234 5670 2',
'account_holder_name' => 'Al Noor Shop',
'national_id' => '123456789'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://mart.ps/api/v1/payout-method"
payload := strings.NewReader("{\n \"iban\": \"PS92 PALS 0000 0000 0400 1234 5670 2\",\n \"account_holder_name\": \"Al Noor Shop\",\n \"national_id\": \"123456789\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.put("https://mart.ps/api/v1/payout-method")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"iban\": \"PS92 PALS 0000 0000 0400 1234 5670 2\",\n \"account_holder_name\": \"Al Noor Shop\",\n \"national_id\": \"123456789\"\n}")
.asString();{
"status": "success",
"status_code": 200,
"message": "OK",
"data": {
"payout_method": {
"status": "locked",
"iban": "PS92PALS000000000400123456702",
"iban_country": "PS",
"account_holder_name": "Al Noor Shop",
"national_id": null,
"updated_at": "2026-11-06T09:30:00+00:00",
"withdrawals_locked_until": "2026-11-08T09:30:00+00:00",
"method": "bank",
"pickup_instructions": null
}
},
"meta": null,
"error": null
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}Save your payout method
Saves how your money is paid. For a bank transfer send iban and account_holder_name, and optionally national_id; method may be left out, as before cash existed. For cash at Mart’s office send "method": "cash", the collector’s full name as account_holder_name and optionally their ID number as national_id; no IBAN. Cash is offered only where Mart allows it for your account (403 cash_not_allowed): save it once before your first cash withdrawal, naming who collects (yourself, or someone with their ID number). A bank transfer is offered only where Mart allows it for your account: elsewhere an IBAN is refused with 422 bank_transfer_not_allowed and nothing is saved. Switching between bank and cash is refused while a withdrawal is open (409 payout_method_change_blocked: cancel it first). A request without method on a cash account switches it back to bank, so it needs an IBAN. Leaving national_id out keeps the one already saved; sending null or an empty string clears it. A switch between bank and cash never carries the ID number over: leaving national_id out on a switch clears it, so send it whenever the collector (or, back to bank, the account holder) has one. The IBAN may be typed with spaces or in lower case: it is stored without them, in upper case. Its check digits, its length for the country and its country are checked: only the countries Mart has enabled for your account are accepted. Saving or changing the IBAN locks withdrawals for a number of hours set for your account (withdrawals_locked_until); a change never shortens a lock that is still running. A switch between bank and cash, and for cash a change of the collector’s name or ID number, locks the same way. For a bank transfer, changing only the name or the national ID does not lock. Saving what is already saved changes nothing and starts no lock. Every change is recorded with who made it. 403 withdrawals_disabled when withdrawals are not enabled for your account. 422 invalid_payout_method when method is neither bank nor cash. 422 bank_transfer_not_allowed for a bank transfer where it is not offered, before the IBAN is checked. 422 invalid_iban says why in error.details.reason (format, country_not_allowed, length, checksum, bban) with country and expected_length where they apply; no error ever repeats what you sent. A paused account can save. When the ledger cannot be read the answer is 503 ledger_unavailable, and nothing is saved. Full behaviour: https://mart.ps/api/docs#money/payout-method-save.
curl --request PUT \
--url https://mart.ps/api/v1/payout-method \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"iban": "PS92 PALS 0000 0000 0400 1234 5670 2",
"account_holder_name": "Al Noor Shop",
"national_id": "123456789"
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
iban: 'PS92 PALS 0000 0000 0400 1234 5670 2',
account_holder_name: 'Al Noor Shop',
national_id: '123456789'
})
};
fetch('https://mart.ps/api/v1/payout-method', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://mart.ps/api/v1/payout-method"
payload = {
"iban": "PS92 PALS 0000 0000 0400 1234 5670 2",
"account_holder_name": "Al Noor Shop",
"national_id": "123456789"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mart.ps/api/v1/payout-method",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'iban' => 'PS92 PALS 0000 0000 0400 1234 5670 2',
'account_holder_name' => 'Al Noor Shop',
'national_id' => '123456789'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://mart.ps/api/v1/payout-method"
payload := strings.NewReader("{\n \"iban\": \"PS92 PALS 0000 0000 0400 1234 5670 2\",\n \"account_holder_name\": \"Al Noor Shop\",\n \"national_id\": \"123456789\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.put("https://mart.ps/api/v1/payout-method")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"iban\": \"PS92 PALS 0000 0000 0400 1234 5670 2\",\n \"account_holder_name\": \"Al Noor Shop\",\n \"national_id\": \"123456789\"\n}")
.asString();{
"status": "success",
"status_code": 200,
"message": "OK",
"data": {
"payout_method": {
"status": "locked",
"iban": "PS92PALS000000000400123456702",
"iban_country": "PS",
"account_holder_name": "Al Noor Shop",
"national_id": null,
"updated_at": "2026-11-06T09:30:00+00:00",
"withdrawals_locked_until": "2026-11-08T09:30:00+00:00",
"method": "bank",
"pickup_instructions": null
}
},
"meta": null,
"error": null
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}{
"status": "fail",
"status_code": 422,
"message": "<string>",
"data": null,
"meta": null,
"error": {
"code": "missing_api_key",
"details": "<unknown>"
}
}Body
Optional. bank (the default when left out) or cash. cash is accepted only when Mart offers it to your account (403 cash_not_allowed), and bank only when Mart offers a bank transfer to your account (422 bank_transfer_not_allowed). You cannot switch between the two while a withdrawal is open (409 payout_method_change_blocked).
bank, cash "bank"
Optional. 5 to 32 letters, digits or hyphens. Arabic digits are accepted and stored as 0 to 9. Omitted keeps the saved one, except on a switch between bank and cash, which clears it; null or an empty string clears it. For cash, the collector's ID number: send it on the switch.
"123456789"
Response
Saved. The same object GET returns. Also 200 when nothing changed.
