For the complete documentation index, see llms.txt. This page is also available as Markdown.

Gömülü Ödeme Formu

MorPOS Gömülü Ödeme Formu (Embedded Payment Form) ile kart bilgileri MorPOS'un güvenli arayüzü üzerinden alınır.


Endpoint

POST /v1/EmbeddedPayment/CreatePaymentForm

Headers

Anahtar
Tür
Açıklama
Örnek

x-ClientID

String

API istemcisi için benzersiz tanımlayıcı

sizin-istemci-id’niz

x-ClientSecret

String

API istemcisi için gizli anahtar

sizin-gizli-anahtarınız

x-GrantType

String

Kullanılan erişim token türü

client_credentials

x-Scope

String

API kapsamı

pf_write, pf_read

x-Timestamp

String

İstek zaman damgası (ISO 8601)

2024-12-17T12:34:56Z


Request Body

Alan
Zorunlu
Tür
Açıklama
Örnek

merchantId

✅

String

Üye işyeri için benzersiz kimlik

100000000000004

returnUrl

✅

URL

Başarılı işlem sonrası yönlendirme URL

failUrl

✅

URL

Başarısız işlem sonrası yönlendirme URL

paymentMethod

✅

String

Ödeme yöntemi

EMBEDDEDPAYMENT

paymentInstrumentType

✅

String

Ödeme aracı türü

CARD

language

✅

String

İşlem dili

en

conversationId

✅

String

Takip için benzersiz kimlik

MP20240305001

sign

✅

String

İsteğin dijital imzası

ABC123...

transactionDetails.transactionType

✅

String

İşlem türü

SALE

transactionDetails.installmentCount

✅

Integer

Taksit sayısı (0 = tek çekim)

0

transactionDetails.amount

✅

Decimal

İşlem tutarı

1.00

transactionDetails.currencyCode

✅

Integer

Para birimi kodu (TRY = 949)

949

transactionDetails.vftFlag

❌

Boolean

VFT kullanım durumu

false

extraParameter.pFSubMerchantId

❌

String

Alt üye işyeri kimliği

12345


Örnek Request

Örnek Response


İşleyiş Notları

  • Kart bilgileri merchant sistemine iletilmez

  • Kart verileri ödeme sağlayıcının gömülü (embedded) ödeme arayüzü üzerinden toplanır

  • PCI-DSS kapsamı önemli ölçüde azaltılır

  • İşlem sonucuna göre kullanıcı returnUrl veya failUrl adresine yönlendirilir

Son güncelleme