Keyed Authorization

An Authorization transaction verifies a customers credit card information and places a hold on the amount requested. A Capture request can be submitted at a later time to convert this authorization into a Sale, that can be settled for payment.

This request can use encrypted values (encrypted_number and encrypted_csc) that were encrypted by the PayTrace Client-Side Encryption JavaScript Library.

Request

Response

POST: /v1/transactions/authorization/keyed

REQUEST:

{
  "amount": "1.00",
  "credit_card": {
    "number": "4111111111111111",
    "expiration_month": "12",
    "expiration_year": "2020"
  },
  "csc": "999",
  "billing_address": {
    "name": "Steve Smith",
    "street_address": "8320 E. West St.",
    "city": "Spokane",
    "state": "WA",
    "zip": "85284"
  }
}

With Client Side Encrypted Data

{
  "amount": "2.00",
  "credit_card": {
    "encrypted_number": "htpAmr1TJ2hujwO/ObS8oFG3/AhF3AU0zh4QzgynFJejRxUOoyJ1MTXW54UD6F2cvuDCgLLMjYu1K8ybAX/Ap4HvsthqdMz5lYhDj1GwcDBUnZQx+upD/8gZNUHnm5S4EZkAXMNT79iwLCd++X97yOatd3jhjxaC0zdRUABYr6PuVEYa7gXTEO3LIiOuAnoLVhrD7ZPni8dnCluyIk2z2k6OwDdCYFwvgpuuZ/luRboG07uYBm1TfHnrLkuCGOxeP7B8Aa0rY1du7GFwXxYadI21AqrgM+DCJLfX156lil0gL4D/ZMQoTIr1hqDr9WKv92V3M+H6Gsx7z0iCbn+8Ug==",
    "expiration_month": "12",
    "expiration_year": "2020"
  },
  "encrypted_csc": "Xd46EqA9ohOD+YVjfSVZAK4/EuQ3RAcqmnfv5h0Tjhew84MARl6yhNdGHW6i+fYJnOQEuDOc3O5RfQqOe6BI8ZboNsmZ82wjPYHe8EiykMdVqNdHVg4xjQBdkexbgA9WLU5Boyc1TmbtJGVpnwDnrR90n0JQpUE/72MSq7evlFXRAIGFcdMyq+QpbLaGi4mI3Fio5L+yn5O0COj8aMD2NalyGFAQmw90dw/4he475o+sGd+2ueEsBHTrDSspfGIACl79lbkSLYa3BRfTkvHAccNRkiY65WftgRW4SGVhs29AD78gNu1kEk/HcrE1PGW1RVC/e2dPT0okKFm4v+cW/w==",
  "billing_address": {
    "name": "Steve Smith",
    "street_address": "8320 E. West St.",
    "city": "Spokane",
    "state": "WA",
    "zip": "85284"
  }
}

Field types: R – Required, O – Optional, C - Conditional

RESPONSE:

{
"success": true,
"response_code": 101,
"status_message": "Your transaction was successfully approved.",
"transaction_id": 79195294,
"approval_code": "TAS677",
"approval_message": "EXACT MATCH - Approved and completed",
"avs_response": "Full Exact Match",
"csc_response": "Match",
"external_transaction_id": "",
"masked_card_number": "xxxxxxxxxxxx1111"
}
page revision: 3, last edited: 09 Apr 2015 20:35
Edit Tags History Files Print Site tools + Options