9. Ödeme Başlat

Masterpass üzerinden ödeme başlatmak için bu servisi kullanabilirsiniz

Ödeme Başlat

POST {{Base Address}}/api/paywall/masterpass/payment/init

Yukarıda verilmiş olan adrese istek atmanız yeterli olacaktır. Test ortamı ve Gerçek ortam için 'Base Address' istediğiniz gibi kullanabilirsiniz.

Önemli: Masterpass - Ödeme Başlat servisini kullanabilmeniz için 'Header' alanında 'apikeyprivate' ve 'apiclientprivate' parametrelerini göndermeniz gerekmektedir. PaymentAPI Adresi

Parametre	Tip	Zorunlu	Açıklama
apikeyprivate	string	Evet	Üye işyeri panelinden temin etmiş olduğunuz Private Key.
apiclientprivate	string	Evet	Üye işyeri panelinden temin etmiş olduğunuz Private Client.

Servise gönderilmesi gereken parametreler şu şekildedir:

Parametre	Tip	Zorunlu	Açıklama
SessionId	Guid	Evet	Oturum Kimliği bilgisi

Json

{
    "SessionId": "8496433e-f36b-1410-825e-001264113a90",
    "Force3D": false,
    "AutoCommit": true,
    "PaymentDetail": { 
        "Amount": 50,
        "MerchantUniqueCode": "{{$guid}}",
        "TrackingCode": "test1132412341412341234--1243-14-23-41-324-123-4",
        "CurrencyId": 1,
        "MerchantSuccessBackUrl": "https://webhook.site/2132fe83-9f0d-461d-ae18-85e9d4a8b0ec",
        "MerchantFailBackUrl": "https://webhook.site/2132fe83-9f0d-461d-ae18-85e9d4a8b0ec",
        "ClientIP": "34.123.2.45",
        "Installment": 1,
        "ChannelId": 0,
        "TagId": 0,
        "PayWatch": null,
        "PayWatchMultipleSupport": false,
        "PayWatchMultiple": null
    },
    "Card": {
        "IsSavedCard": true,
        
        // For SavedCard
        "CardAlias": "55daa93d-4a99-45de-9431-bb93d0bbf92e",
        "CardBin": "552879",
        "CardMasked": "552879********08",

        // For not SavedCard
        "OwnerName": "test",
        "Number": "5528790000000008",
        "ExpireMonth": "12",
        "ExpireYear": "2030",
        "Cvv": "123"
    },
    "Customer": {
        "IdentityNumber": "11111111110"
    },
    "Products": [
        {
            "MemberId": 994,
            "MemberEarningCalculated": false,
            "MemberEarning": 138,
            "MemberCustomCommission": false,
            "MemberCommission": 5,
            "ProductId": "1-1-1-1234342342------1--7-8-9",
            "ProductName": "Nakliye Hizmeti",
            "ProductCategory": "123",
            "ProductDescription": "Nakliye 123",
            "ProductAmount": 50,
            "DiscountOwnerType": 0,
            "DiscountType": 0,
            "DiscountValue": 0,
            "CargoType": 0,
            "CargoCurrencyId": 0,
            "CargoCost": 0
        }
    ]
}

C#

// Soon

GO

// Soon

Java

// Soon

PHP

// Soon

Python

// Soon

Ruby

// Soon

TypeScript

// Soon

Curl

// Soon

Servisten dönen cevap:

Parametre	Tip	Açılama
Body	object	Ödemeye ilişkin detay içeren JSON (opsiyonel)
ErrorCode	int	Hata kodu. İşlem başarılı ise '0' değerini döner.
Result	bool	True ya da false değeri döner. İşlem başarılı iste 'true' değerini döner
Message	string	İşlem hatalıysa, bu hataya dair belirtilen mesajdır, locale parametresine göre dil desteği sunar.

Başarılı ✅

{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 0,
    "Result": true,
    "Message": "Success",
    "Body": {
        "Session": {
            "SessionRenewed": false,
            "SessionId": "dc27433e-f36b-1410-80e5-004205aa382d"
        },
        "Masterpass": {
            "Paywall": {
                "MasterpassPaymentId": "e9b18fc1-1915-4876-8ad8-c1aafada747f",
                "PaymentId": 6618969,
                "ActivityId": 14597573,
                "UniqueCode": "9ee137ed-8dba-414e-9115-ee2cc774acf5",
                "MerchantUniqueKey": "ecae9baa-ba88-441e-b99e-42dd79aef4b5",
                "PaymentGatewayId": 4142,
                "PaymentGatewayName": "Masterpass",
                "PaymentGatewayProviderName": "Masterpass",
                "Products": [
                    {
                        "Id": 6962735,
                        "MemberId": 0,
                        "MemberEarningCalculated": false,
                        "MemberEarning": 0.0,
                        "ProductId": "1-1-1-1234342342------1--7-8-9",
                        "ProductName": "Nakliye Hizmeti",
                        "ProductCategory": "123",
                        "ProductDescription": "Nakliye 123",
                        "ProductAmount": 50.0
                    }
                ]
            },
            "Provider": {
                "IsOtp": false,
                "IsThreeD": true,
                "ThreeDAddress": "https://dev-payment-agent.itspaywall.com/paywall/callbackmasterpass?UniqueNumber=e9b18fc1-1915-4876-8ad8-c1aafada747f",
                "Detail": {
                    "Result": {
                        "ResponseCode": "5010",
                        "Description": "Telefonunuza gelen tek kullanımlık şifreyi girerek işleminizi tamamlayınız",
                        "Token": "e85525f1077640ba8ba2423f2c1ffc41",
                        "RetrievalReferenceNumber": "200007817889",
                        "MaskedNumber": "************0008",
                        "TerminalGroupId": "78516638760698041272198"
                    },
                    "BuildId": "105",
                    "CorrelationId": "e3aa50c2-d749-4513-8a9b-22e151ad6da6",
                    "Exception": null,
                    "Message": "Accepted",
                    "RequestId": null,
                    "StatusCode": 202,
                    "Version": null
                }
            },
            "Error": {
                "ProviderErrorCode": null,
                "ProviderErrorMessage": null
            }
        }
    }
}

Başarısız ❌

{
    "ErrorCodeType": 1,
    "ErrorMessage": null,
    "ErrorCode": 78,
    "Result": false,
    "Message": "Masterpass payment request failed",
    "Body": {
        "Session": {
            "SessionRenewed": false,
            "SessionId": "ca27433e-f36b-1410-80e5-004205aa382d"
        },
        "Masterpass": {
            "Paywall": {
                "MasterpassPaymentId": null,
                "PaymentId": 0,
                "ActivityId": 0,
                "UniqueCode": "",
                "MerchantUniqueKey": "",
                "PaymentGatewayId": 0,
                "PaymentGatewayName": "",
                "PaymentGatewayProviderName": "",
                "Products": null
            },
            "Provider": {
                "IsOtp": false,
                "IsThreeD": false,
                "ThreeDAddress": "",
                "Detail": {
                    "Result": null,
                    "BuildId": "105",
                    "CorrelationId": null,
                    "Exception": {
                        "Level": "NotFound",
                        "Code": "CARD_NOT_FOUND",
                        "Message": "Kart bulunamadı."
                    },
                    "Message": "NotFound",
                    "RequestId": null,
                    "StatusCode": 404,
                    "Version": null
                }
            },
            "Error": {
                "ProviderErrorCode": null,
                "ProviderErrorMessage": null
            }
        }
    }
}