Sale (Immediate Capture)
Process payments instantly with a single API call—ideal for immediate-order fulfillment.
A Direct Sale combines authorization and capture into a single transaction. This means that the system immediately verifies the payment details, reserves the funds, and transfers them to your account—all in one seamless API call.
When to use Direct Sale:
Use Direct Sale when the product or service is delivered immediately after payment. Common scenarios include:
- Instant Order Fulfilment: Digital goods, downloadable content, online courses, and streaming access.
- Immediate Service Completion: On-demand services such as ride-sharing, one-time consultations, or freelance gigs.
- Retail/E-Commerce Checkout: Where goods are shipped right after order confirmation.
Create Sale
To create a Direct Sale:
-
Use the POST
/checkout/v3/payment
endpoint that includes:Parameter Description ternderType
Set to CARD
for card transactions.amount
Amount of Sale (in US currency units) cardAccount
Valid Card details or secure Token. Refer to Card Vaulting to generate a valid token. merchantId
Merchant location ID -
PCE authorizes the payment with the issuer, captures the funds instantly. The GET
/checkout/v3/payment/{id}
endpoint gives a response with:id
: Unique identifier for the paymentpaymentToken
: Secure token for future operations like void, adjustments or refunds.status
: Status of the sale. You will also receive the result in a webhook.
-
Wait for the SALE webhook to learn the outcome of the request.
You can store the id
and paymentToken
for:
- Retrieving payment details later.
- Voiding the payment (if needed).
- Issuing partial or full refunds.
- Making post-sale adjustments.
Testing & Go Live
Use the following test scenarios to simulate Direct Sale transactions during integration.
Expected Behavior:
- The transaction is authorized and captured immediately.
- A batch is created at the time of sale.
- You receive instant confirmation of success or failure via Tranasction status.
Test Scenario | Test Card Number | Amount | Status |
---|---|---|---|
Approved Sale | 4761 3400 0000 0050 | Any | APPROVED - Upon card transaction being authorized by issuing bank. |
Insufficient Funds | 4100 0000 0000 0001 | $100 | FAILED - Transaction failed due to insufficient funds. |
Incorrect CVV | 4100 0000 0000 0019 | Any | FAILED - Transaction failed due to incorrect CVV. |
See Also
Updated 15 days ago