PIN Debit Services

This section describes how to process PIN debit transactions that use these services:
  • Contactless EMV purchases
  • Swiped purchases
  • Cash back
  • Credits
  • Electronic Benefits Transfer (EBT) transactions:
    • EBT cash benefit account purchases
    • EBT Supplemental Nutrition Assistance Program (SNAP) account purchases
    • EBT voucher purchases
    • EBT purchases with cash back
    • EBT credits
    • EBT reversals
  • Merchant-initiated reversals
  • Partial authorizations

PIN Debit Purchase with Contactless EMV

This section describes how to process a PIN debit purchase with contactless EMV when the customer taps the card on the terminal.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments
PIN Debit Services

PIN Debit Purchase with Contact EMV

This section describes how to process a PIN debit purchase with contact EMV when the customer inserts the card into the terminal.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments
PIN Debit Services

PIN Debit Purchase with Contactless EMV and Cash Back

This section describes how to process a PIN debit purchase with contactless EMV and cash back.

Field Specific to This Use Case

This API field is specific to this use case:

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments
PIN Debit Services

PIN Debit Purchase with Swiped Track Data and Merchant Descriptors

This section describes how to process a PIN debit purchase with swiped track data and merchant descriptors.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments
PIN Debit Services

PIN Debit Partial Authorization with Swiped Track Data

This section describes how to process a PIN debit partial authorization with swiped track data.

Fields Specific to This Use Case

This API request field is specific to this use case:

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments
PIN Debit Services

PIN Debit Purchase with Contactless EMV and a Surcharge Fee

This section describes how to process a EMV PIN debit purchase with contactless EMV and a surcharge fee.

Field Specific to This Use Case

This API request field is specific to this use case:

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments
PIN Debit Services

PIN Debit Balance Inquiry with Contactless EMV

This section describes how to process a PIN debit balance inquiry with contactless EMV.

Fields Specific to This Use Case

This API request field and value is specific to this use case:
processingInformation.authorizationOptions.balanceInquiry
Set this field to
true
.
These API response fields are returned in this use case:
paymentInformation.accountFeatures.accountType
paymentInformation.accountFeatures.balanceAmount
paymentInformation.accountFeatures.balanceAmountType
paymentInformation.accountFeatures.balanceSign
paymentInformation.accountFeatures.currency

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments
PIN Debit Services

PIN Debit Balance Inquiry with Swiped Track Data

This section describes how to process a PIN debit balance inquiry with swiped track data.

Fields Specific to This Use Case

This API request field and value is specific to this use case:
processingInformation.authorizationOptions.balanceInquiry
Set this field to
true
.
These API response fields are returned in this use case:
paymentInformation.accountFeatures.accountType
paymentInformation.accountFeatures.balanceAmount
paymentInformation.accountFeatures.balanceAmountType
paymentInformation.accountFeatures.balanceSign
paymentInformation.accountFeatures.currency

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments
PIN Debit Services

PIN Debit Credit with Swiped Track Data

This section describes how to process a PIN debit credit with swiped track data.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/credits/
Test:
POST
https://apitest.cybersource.com
/pts/v2/credits/
PIN Debit Services

PIN Debit Credit with Contactless EMV

This section describes how to process a PIN debit credit with contactless EMV.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/credits/
Test:
POST
https://apitest.cybersource.com
/pts/v2/credits/
PIN Debit Services

Reverse a PIN Debit Purchase or Credit

This section describes how to request a merchant-initiated reversal for a PIN debit purchase or credit when you do not receive a response message for your original transaction request.
Send the merchant-initiated reversal request to the voids endpoint.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments/
{id}
/voids
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments/
{id}
/voids
The
{id}
 is the transaction ID returned in the purchase response.
PIN Debit Services

PIN Debit EBT Purchase with a SNAP Voucher

This section describes how to process a PIN debit EBT purchase with a SNAP voucher.

Fields Specific to This Use Case

These API request fields and values are specific to this use case:

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments
PIN Debit Services

PIN Debit EBT Purchase with SNAP Account Swiped Track Data

This section describes how to process a PIN debit EBT purchase with a SNAP account swiped track data.

Fields Specific to This Use Case

These API request fields and values are specific to this use case:
processingInformation.electronicBenefitsTransfer.category
Set this field to
FOOD
.
processingInformation.purchaseOptions.isElectronicBenefitsTransfer
Set this field to
true
.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments
PIN Debit Services

PIN Debit EBT Purchase with SNAP Account Swiped Track Data and Balance Inquiry

This section describes how to process a PIN debit EBT purchase with SNAP account swiped track data and balance inquiry.

Fields Specific to This Use Case

These API request fields and values are specific to this use case:
processingInformation.authorizationOptions.balanceInquiry
Set this field to
true
.
processingInformation.electronicBenefitsTransfer.category
Set this field to
FOOD
.
processingInformation.purchaseOptions.isElectronicBenefitsTransfer
Set this field to
true
.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments
PIN Debit Services

PIN Debit EBT Purchase with a Cash Benefits Account Swiped Track Data and Cash Back

This section describes how to process a PIN debit EBT purchase with a cash benefits account swiped track data and cash back.

Fields Specific to This Use Case

These API request fields and values are specific to this use case:
processingInformation.electronicBenefitsTransfer.category
Set this field to
CASH
.
processingInformation.purchaseOptions.isElectronicBenefitsTransfer
Set this field to
true
.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments
PIN Debit Services

Credit a PIN Debit EBT Purchase with SNAP Account

This section describes how to credit a PIN debit EBT purchase with a SNAP account.

Fields Specific to This Use Case

These API request fields and values are specific to this use case:
processingInformation.electronicBenefitsTransfer.category
Set this field to
FOOD
.
processingInformation.purchaseOptions.isElectronicBenefitsTransfer
Set this field to
true
.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/credits/
Test:
POST
https://apitest.cybersource.com
/pts/v2/credits/
PIN Debit Services

Reverse a PIN Debit EBT Purchase

This section describes how to reverse a PIN debit EBT purchase.
You can reverse these types of transactions:
  • Purchase from a cash benefits account
  • Purchase from a SNAP account
  • Purchase manually entered from a SNAP account
  • Electronic voucher purchase from a SNAP account
Send the reversal request to the voids endpoint.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments/
{id}
/voids
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments/
{id}
/voids
The
{id}
 is the transaction ID returned in the purchase response.
PIN Debit Services