🇹🇷Turkey

Wallets - Papara

• payout_method.type = wallet

• payout_method.payment_method = wallets

payout_method_details Parameter	Type	Required	Description
first_name	string	Yes	Beneficiary’s first name. Max 50 char
last_name	string	Yes	Beneficiary’s last name. Max 50 char
account_type	string	Yes	“papara_mobile” “papara_number”
phone_number	string	No	E164 format e.g. +90XXXXXXXXXXX International code + 10 digits Mandatory only if account_type = “papara_mobile”.
account_number	string	No	Either 10 digits (e.g. 1234567890) or with a 2 char prefix (e.g. PL1234567890) Mandatory only if account_type = “papara_number”.
bank_code	string	Yes	“PAPARA”

Example Wallet Payload

Example Request

{
    "payout_method": {
        "type": "wallet",
        "payment_method": "wallets",
        "beneficiary": {
            "name": "John Doe",
            "payout_method_details": {
                "first_name": "John",
                "last_name": "Doe",
                "phone_number": "[phone]",
                "account_currency": "TRY",
                "account_name": "John Doe",
                "account_number": "PL1234567890",
                "account_type": "papara_mobile",
                "bank_code": "PAPARA",
            }
        }
    },
    "amount": {
        "value": "2000.00",
        "currency_code": "TRY"
    },
    "country_code": "TR",
    "purpose": "salaries",
    "reference": "Invoice #12345",
    "request_id": "unique_request_id",
}

Example Response

{
    "purpose": "salaries",
    "reference": "Invoice #12345",
    "id": "bd0e110a-c659-4982-be37-04b44a0a139d",
    "payout_method": {
        "type": "wallet",
        "payment_method": "tr_wallets",
        "beneficiary_details": {
            "name": "John Doe"
        }
    },
    "amount": {
        "value": 2000.00,
        "currency_code": "TRY"
    },
    "country_code": "TR",
    "request_id": "unique_request_id",
    "created_at": 1715068306
}

Bank Transfer

• payout_method.type = bank_transfer

• payout_method.payment_method = bank_transfer

payout_method_details Parameter	Type	Required	Description
first_name	string	Yes	Beneficiary’s first name. Max 50 char
last_name	string	Yes	Beneficiary’s last name. Max 50 char
phone_number	string	Yes	E164 format e.g. +90XXXXXXXXXXX International code + 10 digits
account_number	string	Yes	IBAN, 26 char. See “Turkey Bank Account Number Validation” below.

Turkey Bank Account Number Validation

Validation	Type	Length	Type	Verification
Bank account	IBAN	26	Characters	IBAN algorithm

Example Bank Transfer Payload

Example Request

{
  "payout_method": {
    "type": "bank_transfer",
    "payment_method": "bank_transfer",
    "beneficiary": {
      "name": "John Doe",
      "payout_method_details": {
        "first_name": "John",
        "last_name": "Doe",
        "phone_number": "[phone]",
        "account_number": "TR320010009999901234567890",
        "bank_code": "AUB"
      }
    }
  },
  "amount": {
    "value": "11.11",
    "currency_code": "TRY"
  },
  "country_code": "TR",
  "purpose": "salaries",
  "reference": "Invoice #12345",
  "request_id": "unique_request_id"
}

Example Response

{
    "purpose": "SALARIES",
    "reference": "Invoice #12345",
    "id": "3b736ae4-6c38-4b5f-b389-1ab781640d22",
    "payout_method": {
        "type": "bank_transfer",
        "payment_method": "tr_bank_transfer",
        "beneficiary_details": {
            "name": "John Doe"
        }
    },
    "amount": {
        "value": 11.11,
        "currency_code": "TRY"
    },
    "country_code": "TR",
    "request_id": "unique_request_id",
    "created_at": 1717132534
}