Guides

Sale

Suggest Edits

A Sale transaction is a type of transaction in which a Merchant charges a customer’s payment card for the purchase of goods or services. The Sale transaction involves the transfer of funds from the customer’s payment card account to the Merchant’s account.

A Sale transaction can be thought of as similar to a simultaneous Auth, and a Capture of that authorization.

📘

Sale vs Auth

A Sale transaction results in the actual transfer of funds from the customer’s account to the Merchant’s account, while an Auth transaction only verifies that the customer has sufficient funds available for a potential purchase. The Sale transaction is a final transaction that results in an actual payment, while an Auth is a temporary hold on the customer’s account to ensure the availability of funds.

API Request Example

A Sale transaction can be created by calling our POST /v1/transactions API endpoint and providing sale for the value of the type property.

Below is a Sale transaction example with the minimum required fields, that was routed to Stripe as a processor.

Sales Transaction 

{
    "merchantId": "mid_2zyd88xrnr90xskmjmqpd0x1vj",
    "type": "sale",
    "payment": {
        "token": "tkn_5kpqt630zh9kdrev2kxmdr66tr"
    },
    "amount": 145
}

{
    "merchantId": "mid_2zyd88xrnr90xskmjmqpd0x1vj",
    "type": "sale",
    "payment": {
        "number": "4321000000000012",
        "cvv": "123",
        "expiration": "1235"
    },
    "amount": 145
}

{
    "amount": 145,
    "authorization": {
        "approvedAmount": 145,
        "avs": "U",
        "cvv": "M",
        "partial": false,
        "processorCode": "approved_by_network",
        "processorMessage": "Payment complete.",
        "processorTransactionId": "ch_3MeKMMAzKBz0Hugp0OhsoRNi",
        "status": "A"
    },
    "createdOn": "2023-02-22T15:35:57Z",
    "currency": "USD",
    "fee": 0,
    "id": "txn_h1rn8c9nd81y9bkgzax2k2rax",
    "merchantId": "mid_2zyd88xrnr90xskmjmqpd0x1vj",
    "payment": {
        "bin": "432100",
        "brand": "VISA",
        "last4": "0012",
        "type": "CREDIT"
    },
    "plan": {
        "id": "plan_57jaev7pna8nftrkr6xksaastw",
        "name": "Stripe Only Plan"
    },
    "platformId": "pfm_7aj2pxrrcg8zs8x6cxyyrwmyqe",
    "processor": {
        "id": "midCon_6v59stftbs837axmpahj21m8jf",
        "name": "Stripe"
    },
    "type": "sale"
}

📘

CVV

Card Verification Value- For further information about how Preczn handles CVV mapping, please see CVV

Updated 7 months ago