PlusPayDevelopers

Reference

LAN message models and enums.

Field names are snake_case. Amounts are numbers in the order currency, VAT-inclusive.

Transaction

Returned by POST_EFTPOS, POST_PAYMENT_START, POST_PAYMENT_CANCEL, POST_EFTPOS_CANCEL and TRANSACTION_RESULT.

FieldTypeNotes
idstringPOS+ transaction id
order_codestring
payment_typePaymentType
payment_methodPaymentMethod
is_partialbool
partial_typeAMOUNT | PRODUCT | null
total_amountnumber
total_paidnumber
amount_duenumber
statusTransactionStatus
action_statusbool
sourcestring | nullfilled by TRANSACTION_RESULT
invoiceobject | nullid, ettn, number, type, date, name, identity, tax_office, urn, url
paymentobject | nullrrn, card_number_masked, slip[]
deliveryobject | nulltype, status

Order

Returned by ORDER_RESULT and ORDER_PAYMENT.

FieldType
order_codestring
statusOrderStatus
grand_totalnumber
total_amountnumber
total_paidnumber
amount_duenumber
results[{ completed: bool, error_message: string | null, data: Transaction }]

Order create

data of ORDER_CREATE and ORDER_MULTI_PAYMENT.

FieldRequiredType
order_codeyesstring
order_dateyesstring, yyyy-MM-dd HH:mm
currencyyesTRY, USD, EUR, GBP
delivery_typeyesDeliveryType
discount_amountyesnumber
productsyesProduct[]
transactionsmulti-payment[{ payment_type, total_amount, payment_method? }]
note, user_id, serial_no, group_code, order_number, special_codenostring
customerno{ code, name, phone, email, address, city, district, identity, tax_office }
installmentnoint
delivery_statusnostring
change_payment_status, can_try_againnobool

Product (all required): id (int), sku, title, unit (ADET, KG, GR, LT, MT, KOLI, PAKET, PORSIYON), price, quantity, tax_rate (int), vat_include (bool), product_type (PHYSICALLY, VIRTUAL, …), discount_value.

The reply is the order detail: id, order_code, status, products, transactions, sub_total, tax_amount, grand_total, total_paid, amount_due, …

Enums

PaymentType — POS, CASH, INSTALLMENT, PAYCELL, HEPSIPAY, ISTANBULCARD, ONLINE, BANK_TRANSFER, GASTROPAY, CIO_CARD, IWALLET, PAYE, MULTINET, METROPOL, FASTPAY, TICKET, EDENRED, SETCARD, SODEXO, GETIRPAY, TOKENFLEX, YEMEKMATIK, ON_CREDIT, VIRTUAL_POS, CUZDANPLUS

PaymentMethod — CC, NFC, QR, CASH, CHIP, SWIPE, NFC_R, QR_R, QUICKCODE, MOBILE, LINK, NONE, PAYCELL_LINK, PAYCELL_MERCHANT_PAGE, ONLINE, TRENDYOL, GETIR, YEMEKSEPETI, MIGROSYEMEK

TransactionStatus — SUCCESS, CANCEL, FAIL, NONE, WAITING, NOT_RESPONSE

OrderStatus — SUCCESS, CANCEL, WAITING, NOT_RESPONSE

DeliveryType — CASH_ORDER, PACKAGE_ORDER, TABLE_ORDER, TAKE_AWAY, TAKE_CLOSE

EodType — POS, CASH, BANK_TRANSFER, ONLINE, OTHER, MULTINET, SODEXO, SETCARD, TICKET, METROPOL, PAYE, TOKENFLEX, EDENRED, CUZDANPLUS, IWALLET