Multinet - Orkesta

Multinet - APM ile Ödeme Alma

POST https://api-test.fincraft.com.tr/api/v1/payments/apm-methods/auth

Bu servis HTML değer sonucu olarak verir. Kullanıcı HTML üzerinden işlemi tamamladıktan sonra callbackUrl üzerinden işlem sonucu alınır.

Request Body

{
    "apmType": "MULTINET",
    "referenceId": "{{$guid}}",
    "amount": 10,
    "callbackUrl": "https://www.deneme.com",
    "currency": "TRY",
    "clientIp": "192.168.1.100",
    "products": [
      {
        "name": "Ürün 1",
        "externalId": "PROD-001",
        "price": 10
      }
    ]
}

Request Parametreleri

Parametre	Tip	Zorunlu	Validation	Açıklama
`apmType`	String	Evet	@NotBlank	Alternatif ödeme yöntemi tipi (`MULTINET`)
`callbackUrl`	String	Evet	@NotBlank	İşlem sonucunun bildirileceği adres (https)
`referenceId`	String	Evet	@NotBlank	İşleme özel benzersiz referans ID
`amount`	Decimal	Evet	@NotNull, @Positive	Toplam işlem tutarı
`currency`	String	Evet	@NotBlank	Para birimi (TRY)
`clientIp`	String	Evet	@NotBlank	İsteği yapan kullanıcının IP adresi

Response

HTML dönüş yapılacaktır.

Resolve

Eğerki teknik bir problemden dolayı callbackUrl’e işlem iletilemez ise /api/v1/payments/apm-methods/resolve adresine aşağıdaki gibi istek atılabilir:

{
    "referenceId": "33d47b3e-d5d2-421f-b72d-3810692bcea7"
}

{
    "response": {
        "referenceId": "33d47b3e-d5d2-421f-b72d-3810692bcea7",
        "status": "SUCCESS",
        "otpRequired": false,
        "apmTransactionId": "25545510420193899",
        "confirmRequired": false
    }
}