post https://sandbox.bluesnap.com/services/2/alt-transactions
The Create Sofort Transaction request performs a transaction using the Sofort payment method.
Tip
You can test out a request that hits our sandbox in real-time. Follow the instructions here to use the "Try It!" feature on the right side.
Request Content
Send an altTransaction object, with the following:
| Property | Type | Required |
|---|---|---|
amount | decimal | required |
currency | string | required must be a supported currency |
sofortTransaction | object | required (see sofortTransaction) |
payerInfo | object | required for a new shopper (see payerInfo) |
vaultedShopperId | integer | required for a vaulted shopper The vaulted shopper's saved country must be supported by Sofort. |
vendorsInfo | object | optional (see vendorsInfo) |
merchantTransactionId | string | optional |
transactionMetaData | object | optional (see transactionMetaData) |
Response Details
If successful, the response HTTP status code is 200 OK.
The response contains the request properties plus these additions:
| Property | Notes |
|---|---|
vaultedShopperId | |
processingInfo | (see processingInfo) |
fraudResultInfo | (see fraudResultInfo) |
Examples
Request Examples
curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 42,
"currency": "GBP",
"payerInfo": {
"firstName": "John",
"lastName": "Doe",
"country": "uk"
},
"sofortTransaction": {
"returnUrl": "http://www.returnURL.com"
}
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 57,
"currency": "GBP",
"vaultedShopperId": 29896125,
"sofortTransaction": {
"language": "fr",
"returnUrl": "http://www.returnURL.com"
}
}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/alt-transactions/ \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"amount": 50,
"currency": "EUR",
"payerInfo": {
"firstName": "John",
"lastName": "Doe",
"country": "de"
},
"sofortTransaction": {
"returnUrl": "http://www.returnURL.com"
},
"vendorsInfo": {
"vendorInfo": [
{
"vendorId": 837389
}
]
}
}'
Response Examples
{
"amount": 42,
"currency": "GBP",
"payerInfo": {
"firstName": "John",
"lastName": "Doe",
"country": "uk"
},
"vaultedShopperId": 29896125,
"sofortTransaction": {
"sofortUrl": "https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000209224930000100001&MAC=k4cr6oNG%2FYtDMwfKJWwveKOSA6V3xDS8j0qFWZD7IyA%3D",
"orderId": 20922493
},
"processingInfo": {
"processingStatus": "PENDING"
}
}
{
"amount": 57,
"currency": "GBP",
"vaultedShopperId": 29896125,
"sofortTransaction": {
"language": "fr",
"sofortUrl": "https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000209224950000100001&MAC=sl2YU%2FDhliWFMZwzXXzDSFbyKKuS2Ll%2FncE794IvTKg%3D",
"orderId": 20922495
},
"processingInfo": {
"processingStatus": "PENDING"
}
}
{
"vendorsInfo": {
"vendorInfo": [
{
"vendorId": 837389,
"commissionPercent": 30
}
]
},
"amount": 50,
"currency": "EUR",
"payerInfo": {
"firstName": "John",
"lastName": "Doe",
"country": "de"
},
"vaultedShopperId": 29896135,
"sofortTransaction": {
"sofortUrl": "https://eu.gcsip.nl/orb/orb?ACTION=DO_START&REF=000000410000209217110000100001&MAC=0c0N2AF5tQLQ8VGYG0S2eNOIURDNh70FsQI5ingS2M8%3D",
"orderId": 20921711
},
"processingInfo": {
"processingStatus": "PENDING"
}
}
API Explorer
To test out a basic API request, click the "Try It!" button in the right-hand column to test using the default, pre-populated sample values. To test with your own values, edit the parameter fields below. You'll see them populate in the right-hand column and you can click the "Try It!" button to submit your test request and see a response.