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