Skip to main content
POST
TRY Collection Application

Secret Key & Private Key (Generate Signature)

Body

application/json
appId
integer
required

Business ID (obtained from the backend; must match the currency in the URL)

orderId
string
required

Merchant Order ID

Maximum string length: 48
name
string
required

Payee Name

phone
string
required

Valid phone number

email
string<email>
required

Valid email

amount
string
required

Transaction amount (in local currency)

Pattern: ^\d+\.\d{2}$
payType
string
required

Transaction Type PAYMENT_GATEWAY

inBankCode
string
required
callBackUrl
string<uri>
required

Redirect URL after successful payment

callBackFailUrl
string<uri>
required

Redirect URL after failed payment

partnerUserId
string
required

Unique user identifier (e.g., userId), required for risk control. Must be valid; otherwise it may affect the transaction. Format: numbers, letters, or symbols -~!@#$%&*()_.

Pattern: ^[A-Za-z0-9\-~!@#$%&*()_]+$
sign
string
required

Signature

currency
string

Currency (TRY)

notifyUrl
string<uri>

Callback URL

subject
string

Payment remark (transaction title, product name, or payment reason)

body
string

Remark details

Response

200 - application/json
status
string

1: Normal, 0: Exception

error
string

Error code

msg
string

Error description

data
object
Last modified on July 16, 2026