/v1/transactions
Initialize a Secure Fields transaction
Changed onProceed with the steps below to process Secure Fields payment transactions:
- Call the /v1/transactions/secureFields endpoint to retrieve a transactionId. The success result of this API call is a HTTP 201 status code with a transactionId in the response body.
- Initialize the SecureFields JavaScript library with the returned transactionId:
var secureFields = new SecureFields();
secureFields.init(
transactionId, {
cardNumber: "cardNumberPlaceholder",
cvv: "cvvPlaceholder",
});
- Handle the success event of the secureFields.submit() call. Example success event data:
{
"event":"success",
"data": {
"transactionId":"{transactionId}",
"cardInfo":{"brand":"MASTERCARD","type":"credit","usage":"consumer","country":"CH","issuer":"DATATRANS"},
"redirect":"https://pay.sandbox.datatrans.com/upp/v1/3D2/{transactionId}"
}
}
- If 3D authentication is required, the redirect property will indicate the URL that the browser needs to be redirected to.
- Use the Authorize an authenticated transaction endpoint to authorize the Secure Fields transaction. This is required to finalize the authorization process with Secure Fields.
- Use the transactionId to check the status and to settle, cancel or credit (refund) a transaction.
post/v1/transactions/secureFields
Request
- Base URLhttps://api.sandbox.datatrans.com
- URLhttps://api.sandbox.datatrans.com/v1/transactions/secureFields
- AuthHTTP basic
Request body
Response
Transaction successfully initialized
Example response
{
"resources": [
{
"uri": "https://pay.datatrans.com/upp/payment/js/secure-fields-2.0.0.js",
"integrity": "sha384-Base64EncodedHashValue"
}
]
}Changes
- info
endpoint added
- info