1.1 Create Card Payment

Initiates a card payment transaction.

Request

Method	URL
POST	/payment/v1/card-payments

Post Data

{
  "price": 100.0,
  "paidPrice": 100.0,
  "walletPrice": 100.0,
  "installment": 1,
  "buyerMemberId": 1,
  "currency": "TRY",
  "paymentGroup": "PRODUCT",
  "paymentPhase": "AUTH",
  "paymentChannel": "Online",
  "callbackUrl": "http://example.com/callback",
  "bankOrderId": "111222333",
  "clientIp": "192.168.1.1",
  "card": {
    "cardAlias": "MyCard",
    "cardHolderName": "John Doe",
    "cardNumber": "4022780520669303",
    "expireYear": "50",
    "expireMonth": "01",
    "cvc": "988",
    "storeCardAfterSuccessPayment": false,
    "cardUserKey": "userkey123",
    "cardToken": "cardtoken123",
    "loyalty": null
  },
  "posAlias": "pos1",
  "retry": false,
  "items": [
    {
      "name": "Item1",
      "price": 50.0,
      "externalId": "123",
      "conservationID": "deneme",
      "subMerchantMemberId": null,
      "subMerchantMemberPrice": null
    },
    {
      "name": "Item2",
      "price": 50.0,
      "externalId": "item456",
      "subMerchantMemberId": null,
      "subMerchantMemberPrice": null
    }
  ],
  "additionalParams": "Your additional parameters here",
  "recurring": false,
  "fraudParams": {
    "buyerExternalId": "buyer123",
    "buyerPhoneNumber": "[phone]",
    "buyerEmail": "[e-mail]"
  }
}

Response

Status	Response
200	{ "data": { "createdDate": "2024-01-17T12:34:56", "price": 50.0, "paidPrice": 50.0, "walletPrice": 0.0, "currency": "USD", "buyerMemberId": "buyer123", "installment": 1, "conversationId": "123456", "externalId": "ext123", "paymentType": "CARD_PAYMENT", "paymentGroup": "GROUP1", "paymentSource": "WEB", "paymentStatus": "SUCCESS", "paymentPhase": "PHASE1", "paymentChannel": "WEB", "isThreeDS": false, "merchantCommissionRate": 0.03, "merchantCommissionRateAmount": 1.5, "bankCommissionRate": 0.02, "bankCommissionRateAmount": 1.0, "cardType": "VISA", "cardAssociation": "Visa Inc.", "cardBrand": "Visa", "requestedPosAlias": "pos123", "pos": "Your POS information here", "loyalty": {}, "fraudId": "fraud123", "fraudAction": "BLOCK", "paymentTransactions": [] } }
403
400
400
401
401
500