> For the complete documentation index, see [llms.txt](https://docs.iyzico.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iyzico.com/en/payment-methods/preauth-and-capture/non-3ds/non-3ds-implementation/create-postauth-payment.md).
# Create PostAuth Payment
Create PostAuth Payment API is responsible for finalizing card payments. When this service is used, iyzico provides an instant response regarding the success of the transaction.
## Create PostAuth Payment Request
`POST` `https://api.iyzipay.com/payment/postauth`
#### Request Body
| Name | Type | Description |
| ------------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------- |
| locale | String | Language (default: tr) |
| conversationId | String | Conversation ID to match request and response |
| paymentId\* | Decimal | ID of the payment. Merchants should keep payment ID in their system (this ID will be used for cancel requests) |
| currency\* | String | Currency (default: TRY). Alternatively, you can set USD, EUR, GBP and IRR |
| ip(Buyer)\* | String | IP of buyer |
#### **Create PostAuth Payment Response**
| **status** | String | Service response result (success / failure) |
| ----------------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **errorCode** | String | Error code if service response status is failure |
| **errorMessage** | String | Error message if service response status is failure |
| **errorGroup** | String | Error group if service response status is failure |
| **locale** | String | Language (default: tr) |
| **systemTime** | Long | Response system timestamp value |
| **conversationId** | String | If set, conversation ID to match request and response |
| **paymentId** | String | ID of the payment. Merchants should keep payment ID in their system (this ID will be used for cancel requests) |
| **price** | Decimal | Total amount of basket. The sum of basket items’ amount must be equal to the price of basket |
| **paidPrice** | Decimal | Final amount (including installment fee) that will be charged to customer’s card. Merchants should store this value in their system |
| **currency** | String | Currency of request |
| **installment** | Integer | Installment number of payment, for single payments it returns 1. Valid values are 1, 2, 3, 6, 9, 12 |
| **basketId** | String | Merchant's basket ID |
| **binNumber** | String | First 6 digit of card |
| **cardAssociation** | String | Valid values are VISA, MASTER\_CARD, AMERICAN\_EXPRESS, TROY |
| **cardFamily** | String | Valid values are Bonus, Axess, World, Maximum, Paraf, CardFinans, Advantage |
| **cardType** | String | Valid values are CREDIT\_CARD, DEBIT\_CARD, PREPAID\_CARD |
| **fraudStatus** | Integer | Fraud risk status for payment request (0 for review / 1 for accept) |
| **iyziCommissionFee** | Decimal | iyzico commission fee for payment transaction |
| **iyziCommissionRateAmount** | Decimal | iyzico commission rate amount for payment transaction |
| **merchantCommissionRate** | Decimal | Merchant commission rate (e.g. price=100 & paidPrice=110, then merchant commission rate = 10) |
| **merchantCommissionRateAmount** | Decimal | Merchant commission rate amount (e.g. price=100 & paidPrice=110, then merchant commission rate amount = 10) |
| **paymentTransactionId (ItemTransactions)** | String | ID of basket item. Merchants should keep payment ID in their system (this ID will be used for cancel requests) |
| **itemId(ItemTransactions)** | String | Item ID of each item in basket |
| **price(ItemTransactions)** | Decimal | Item price of each item in basket |
| **paidPrice(ItemTransactions)** | Decimal | Captured amount from card based on each item. Merchants should keep paidPrice in their system |
| **transactionStatus (ItemTransactions)** | Integer | Status of a payment transaction. (0 for waiting / -1 for rejected by fraud / 1 for waiting for approval / 2 for approved |
| **blockageRate(ItemTransactions)** | Decimal | Blockage rate based on each item. |
| **blockageRateAmountMerchant(ItemTransactions)** | Decimal | Blockage rate amount for merchant based on each item |
| **blockageResolvedDate(ItemTransactions)** | String | Blockage resolve date based on each item. Date format should be “2015-10-19 14:36:52” |
| **iyziCommissionFee(ItemTransactions)** | Decimal | iyzico commission fee based on each item |
| **iyziCommissionRateAmount(ItemTransactions)** | Decimal | iyzico commission rate amount based on each item |
| **merchantCommissionRate(ItemTransactions)** | Decimal | Merchant commission rate (e.g. price=100 & paidPrice=110, then merchant commission rate = 10) |
| **merchantCommissionRateAmount(ItemTransactions)** | Decimal | Merchant commission rate amount (e.g. price=100 & paidPrice=110, then merchant commission rate amount = 10) |
| **merchantPayoutAmount(ItemTransactions)** | Decimal | Payout amount for each item transaction. This is the amount that remains after after substracting iyzicoCommissionRateAmount, iyzicoCommissionFee and blockageRateAmountMerchant from paidPrice(ItemTransactions) |
| **paidPrice(ItemTransactions)(convertedPayout)** | Decimal | Converted charged amount to card based on each item. Merchants should keep paidPrice in their system. |
| **iyziCommissionFee(ItemTransactions)(convertedPayout)** | Decimal | Converted iyzico commission fee based on each item |
| **iyziCommissionRateAmount(ItemTransactions)(convertedPayout)** | Decimal | Converted iyzico commission rate amount based on each item |
| **blockageRateAmountMerchant(ItemTransactions)(convertedPayout)** | Decimal | Converted blockage rate amount for merchant based on each item |
| **merchantPayoutAmount(ItemTransactions)(convertedPayout)** | Decimal | Converted payout amount for each item transaction. This the amount that remains after substracting iyzicoCommissionRateAmount, iyzicoCommissionFee and blockageRateAmountMerchant from paidPrice(ItemTransactions) |
| **iyziConversationRate(ItemTransactions)(convertedPayout)** | Decimal | iyzico conversation rate |
| **iyziConversationRateAmount(ItemTransactions)(convertedPayout)** | Decimal | iyzico conversation rate amount |
| **currency(ItemTransactions)(convertedPayout)** | String | Currency for payout conversion |
Lastly analyzing following headlines, you can effectively handle and respond to the outcome of the payment inquiry, ensuring a smooth and reliable payment process for your customers.
* The `status` parameter provides information about the status of the transaction. `success` indicates that the transaction has been successfully completed and the payment has been processed. `failure` indicates that the transaction has failed, and an error message related to the failure reason is provided.
* The `paymentStatus` parameter is null for this service.
* The `paymentId` and `paymentTransactionId` values should be stored for future reference and tracking.
* In the event of a failed transaction (`failure` status), the `errorCode`, `errorMessage`, and `errorGroup` parameters will be returned with corresponding values, providing details about the error.