1. 3DS Payments
Corpayss
  • API Changelog
  • Acquirer
    • Merchant
      • Create Merchant
      • Get Merchant
      • Update Merchant
      • Search Merchant
    • Terminal
      • Create Terminal
      • Get Terminal
      • Update Terminal
      • Search Terminal
    • Deprecated - Commission Profile
      • Create Commission Profile
      • Get Commission Profile
      • Update Commission Profile
      • Delete Commission Profile
    • Pos Authorization Profile
      • Create Pos Authorization Profile
      • Get Pos Authorization Profile
      • Update Pos Authorization Profile
      • Delete Pos Authorization Profile
    • Pos Fee Profile
      • Create Pos Fee Profile
      • Get Pos Fee Profile
      • Update Pos Fee Profile
      • Delete Pos Fee Profile
    • Create Merchant and Terminal
      POST
    • Get Merchant Payment Summary
      POST
    • Get Merchant Payment Detail
      POST
    • Get Pos Batch Summary
      POST
    • Get Pos Batch Detail
      POST
    • Close Pos Batch
      POST
  • Issuer
    • Customer
      • Create Customer
      • Get Customer Info
      • Get Card Customer Info
      • Update Customer
      • Update Customer Limit
    • Card
      • Creation & Registration
        • Create Credit Card
        • Create Debit Card
        • Create Prepaid Card
        • Create Emboss Request
        • Register Card
      • Information & Status Management
        • Get Card Info
        • Get Card Status
        • Get Host Balance
        • Update Card Limit
        • Update Card Status
        • Update Card Fee Status
      • Transactions & Balance Operations
        • Get Card Transactions
        • Send Transaction
        • Card To Card Balance Transfer
        • Money Send
        • Load Card Balance
      • Security & Authentication
        • Verify Card
        • Get Card Pin
        • Send PIN By SMS
        • Check Pin
        • Change Card Pin
        • Reset Cvv 2 Retry Count
        • Change 3DS Password
      • Maintenance & Restrictions
        • Get Card Restriction
        • Card Restriction
        • Card Renewal
      • Deprecated
        • Tokenization
          • Tokenize Card No
        • Get Card Balance Loading Limit
        • Get Card No
        • Get Card Private Info
  • Online Payments
    • Card Payments
      • Non-3DS Payments
        • Create Non-3DS Payment
        • Create Non-3DS Pre-Authorization
        • Create Post Authorization
      • 3DS Payments
        • Create 3DS Payment
          POST
        • Create 3DS Pre-Authorization
          POST
        • Complete 3DS Payment
          POST
      • Refunds & Voids
        • Void Payment
        • Refund Payment
    • Payment Links
      • Create 3DS Payment Link
      • Create Non-3DS Payment Link
    • Payment Queries
      • Check Payment by Token
      • Check Payment by Order ID
      • Check Payment by Process ID
      • List Payments by Order ID
    • Recurring Payments
      • Pause Recurring
      • Resume Recurring
      • Reset Plan To Pending
      • Create Recurring
      • Get Recurring
      • Update Recurring
      • Cancel Recurring
    • Batch
      • Batch Close
    • DEPRECATED
      • QR Transaction
        • QR Payment CreateQr
      • Installment Inquiry
      • Point Inquiry
  1. 3DS Payments

Create 3DS Pre-Authorization

POST
/api/ThreeD/PreSale
Inquiring the transaction result with Order ID.

Request

Header Params

Body Params application/json

Example
{
    "orderId": "{{$timestamp}}",
    "cardNo": "5265440045156285",
    "expiry": "3104",
    "cvv2": "552",
    "amount": 550,
    "currency": 978,
    "requestType": "3DS-PAY",
    "txnInitiationType": 0,
    "credentialOnFileType": 0,
    "credentialOnFileIteration": 0,
    "cardHolderIp": "SUV",
    "merchantIp": "114.82.56.19",
    "subMerchantIp": "83.133.216.115",
    "lang": "EN",
    "additionalInfo": "culpa pariatur velit reprehenderit",
    "invoiceInfo": "culpa tempor ut",
    "cardholderName": "Minivan",
    "cardholderEmail": "Franz.Lowe@gmail.com",
    "returnUrl": "https://grim-monocle.com/",
    "callbackUrl": "https://another-popularity.name/",
    "subMerchantId": "58",
    "subMerchantName": "Hilda D'Amore MD",
    "subMerchantMcc": "5411",
    "subMerchantPostalCode": "33161-6042",
    "subMerchantCity": "Kshlerinport",
    "subMerchantCountryCode": "BM"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://vpospayment.corpayss.net/api/ThreeD/PreSale' \
--header 'x_client_token: b3ade1f7-aaa5-4f8b-9fa2-62f8d54c92f7' \
--header 'Accept-Language: EN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orderId": "{{$timestamp}}",
    "cardNo": "5265440045156285",
    "expiry": "3104",
    "cvv2": "552",
    "amount": 550,
    "currency": 978,
    "requestType": "3DS-PAY",
    "txnInitiationType": 0,
    "credentialOnFileType": 0,
    "credentialOnFileIteration": 0,
    "cardHolderIp": "SUV",
    "merchantIp": "114.82.56.19",
    "subMerchantIp": "83.133.216.115",
    "lang": "EN",
    "additionalInfo": "culpa pariatur velit reprehenderit",
    "invoiceInfo": "culpa tempor ut",
    "cardholderName": "Minivan",
    "cardholderEmail": "Franz.Lowe@gmail.com",
    "returnUrl": "https://grim-monocle.com/",
    "callbackUrl": "https://another-popularity.name/",
    "subMerchantId": "58",
    "subMerchantName": "Hilda D'\''Amore MD",
    "subMerchantMcc": "5411",
    "subMerchantPostalCode": "33161-6042",
    "subMerchantCity": "Kshlerinport",
    "subMerchantCountryCode": "BM"
}'

Responses

🟢200OK
application/json
Success
Bodyapplication/json

Example
{}
Modified at 2026-06-16 12:54:46
Previous
Create 3DS Payment
Next
Complete 3DS Payment
Built with