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

Last updated