/ Guides / Get started / Use the sandbox / Simulate card authorisations

Simulate card authorisations

Learn how to test authorisations and authorisation clearings.

info

These endpoints are for sandbox only. They won't work in production.

Simulate an authorisation

Post/v2/simulations/transaction/authorization

Request

Use this request to simulate a card authorisation.

Sample requestRequest structure
Copy
Copied
curl -i -X POST \
  'https://api.equalsmoney.com/v2/simulations/transaction/authorization' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "cardId": "53494ad2-6477-402c-9f6e-dd50ea11f851",
    "amount": 10.00,
    "network": "VISA",
    "cardAcceptor": {
      "mid": "11111"
    }
  }'
Copy
Copied
curl -i -X POST \
  'https://api.equalsmoney.com/v2/simulations/transaction/authorization' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "cardId": "string",
    "amount": number,
    "network": "string",
    "cardAcceptor": {
      "mid": "string"
    }
  }'

Request body schema

Parameter Description
cardId
string (uuid)
required		 The ID of the card to work with.

Allowable values:
An existing cardId (<= 36 characters)
amount
number		 The amount of the transaction.

Allowable values:
A valid number (>= 0)
network
string		 The card network.

Allowable values:
A valid string
cardAcceptor
object
required		 Details about the card acceptor.

Allowable values:
A valid cardAcceptor object containing the following field: mid
cardAcceptor.mid
string
required		 The Merchant Identifier (MID).

Allowable values:
<= 36 characters

Response

If your request is successful, you'll receive a 201 response.

Sample responseResponse structure
Copy
Copied
{
  "type": "authorization",
  "state": "PENDING",
  "token": "7bff9f48-8c68-4937-917a-bf7cf4f0de27",
  "userToken": "f0d5cae0-fb3f-417f-8f1c-51c5fb66259a",
  "cardToken": "53494ad2-6477-402c-9f6e-dd50ea11f851",
  "response": {
    "code": 0,
    "memo": "Approved or completed successfully"
  },
  "createdTime": "2022-12-06T21:41:48Z",
  "userTransactionTime": "2022-12-06T21:41:49Z",
  "settlementDate": "2022-12-06T21:41:50Z",
  "amount": 10.00,
  "gpa": {
    "ledgerBalance": 240.00,
    "availableBalance": 240.00,
    "impactedAmount": -10.00
  },
  "currencyCode": "GBP",
  "currencyConversion": {
    "originalAmount": 10.00,
    "conversionRate": 1.00,
    "originalCurrencyCode": 826
  },
  "precedingRelatedTransactionToken": "8a6d911e-cb3d-41d2-b843-5f9dc97d503c",
  "network": "VISA",
  "subnetwork": "VISANET",
  "cardAcceptor": {
    "mid": "11111",
    "mcc": "6411",
    "name": "EM",
    "city": "Seattle",
    "state": "WA",
    "countryCode": "USA"
  }
}
Copy
Copied
{
  "type": "string",
  "state": "string",
  "token": "string",
  "userToken": "string",
  "cardToken": "string",
  "response": {
    "code": number,
    "memo": "string"
  },
  "createdTime": "string",
  "userTransactionTime": "string",
  "settlementDate": "string",
  "amount": number,
  "gpa": {
    "ledgerBalance": number,
    "availableBalance": number,
    "impactedAmount": number,
  },
  "currencyCode": "string",
  "currencyConversion": {
    "originalAmount": number,
    "conversionRate": number,
    "originalCurrencyCode": number
  },
  "precedingRelatedTransactionToken": "string",
  "network": "string",
  "subnetwork": "string",
  "cardAcceptor": {
    "mid": "string",
    "mcc": "string",
    "name": "string",
    "city": "string",
    "state": "string",
    "countryCode": "string"
  }
}

For more detailed information about this request and its response, see the API reference.

Simulate an authorisation advice

Post/v2/simulations/transaction/authorization/advice

Request

Use this request to simulate a card authorisation advice.

Sample requestRequest structure
Copy
Copied
curl -i -X POST \
  'https://api.equalsmoney.com/v2/simulations/transaction/authorization/advice' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "precedingRelatedTransactionToken": "9d3dee7c-19df-4b71-bbb9-521bb04307bf",
    "amount": 10.00
  }'
Copy
Copied
curl -i -X POST \
  'https://api.equalsmoney.com/v2/simulations/transaction/authorization/advice' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "precedingRelatedTransactionToken": "string",
    "amount": number
  }'

Request body schema

Parameter Description
precedingRelatedTransactionToken
string
required		 The token of the transaction to work with. This is the token received in the response to the authorisation request.

Allowable values:
A valid string
amount
number
required		 The authorisation clearing amount.

Allowable values:
A valid number (>= 0)

Response

If your request is successful, you'll receive a 201 response.

Sample responseResponse structure
Copy
Copied
{
  "type": "authorization.advice",
  "state": "PENDING",
  "token": "7bff9f48-8c68-4937-917a-bf7cf4f0de27",
  "userToken": "f0d5cae0-fb3f-417f-8f1c-51c5fb66259a",
  "cardToken": "53494ad2-6477-402c-9f6e-dd50ea11f851",
  "response": {
    "code": 0,
    "memo": "Approved or completed successfully"
  },
  "createdTime": "2022-12-06T21:41:48Z",
  "userTransactionTime": "2022-12-06T21:41:49Z",
  "settlementDate": "2022-12-06T21:41:50Z",
  "amount": 10.00,
  "gpa": {
    "ledgerBalance": 240.00,
    "availableBalance": 240.00,
    "impactedAmount": -10.00
  },
  "currencyCode": "GBP",
  "currencyConversion": {
    "originalAmount": 10.00,
    "conversionRate": 1.00,
    "originalCurrencyCode": 826
  },
  "precedingRelatedTransactionToken": "8a6d911e-cb3d-41d2-b843-5f9dc97d503c",
  "network": "VISA",
  "subnetwork": "VISANET",
  "cardAcceptor": {
    "mid": "11111",
    "mcc": "6411",
    "name": "EM",
    "city": "Seattle",
    "state": "WA",
    "countryCode": "USA"
  }
}
Copy
Copied
{
  "type": "string",
  "state": "string",
  "token": "string",
  "userToken": "string",
  "cardToken": "string",
  "response": {
    "code": number,
    "memo": "string"
  },
  "createdTime": "string",
  "userTransactionTime": "string",
  "settlementDate": "string",
  "amount": number,
  "gpa": {
    "ledgerBalance": number,
    "availableBalance": number,
    "impactedAmount": number,
  },
  "currencyCode": "string",
  "currencyConversion": {
    "originalAmount": number,
    "conversionRate": number,
    "originalCurrencyCode": number
  },
  "precedingRelatedTransactionToken": "string",
  "network": "string",
  "subnetwork": "string",
  "cardAcceptor": {
    "mid": "string",
    "mcc": "string",
    "name": "string",
    "city": "string",
    "state": "string",
    "countryCode": "string"
  }
}

For more detailed information about this request and its response, see the API reference.

Simulate an authorisation clearing

Post/v2/simulations/transaction/authorization/clearing

Request

Use this request to simulate a card authorisation clearing.

Sample requestRequest structure
Copy
Copied
curl -i -X POST \
  'https://api.equalsmoney.com/v2/simulations/transaction/authorization/clearing' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "precedingRelatedTransactionToken": "9d3dee7c-19df-4b71-bbb9-521bb04307bf",
    "amount": 10.00
  }'
Copy
Copied
curl -i -X POST \
  'https://api.equalsmoney.com/v2/simulations/transaction/authorization/clearing' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "precedingRelatedTransactionToken": "string",
    "amount": number
  }'

Request body schema

Parameter Description
precedingRelatedTransactionToken
string
required		 The token of the transaction to work with. This is the token received in the response to the authorisation request.

Allowable values:
A valid string
amount
number
required		 The authorisation clearing amount.

Allowable values:
A valid number (>= 0)

Response

If your request is successful, you'll receive a 201 response.

Sample responseResponse structure
Copy
Copied
{
  "type": "authorization.clearing",
  "state": "COMPLETION",
  "token": "7bff9f48-8c68-4937-917a-bf7cf4f0de27",
  "userToken": "f0d5cae0-fb3f-417f-8f1c-51c5fb66259a",
  "cardToken": "53494ad2-6477-402c-9f6e-dd50ea11f851",
  "response": {
    "code": 0,
    "memo": "Approved or completed successfully"
  },
  "createdTime": "2022-12-06T21:41:48Z",
  "userTransactionTime": "2022-12-06T21:41:49Z",
  "settlementDate": "2022-12-06T21:41:50Z",
  "amount": 10.00,
  "gpa": {
    "ledgerBalance": 240.00,
    "availableBalance": 240.00,
    "impactedAmount": -10.00
  },
  "currencyCode": "GBP",
  "currencyConversion": {
    "originalAmount": 10.00,
    "conversionRate": 1.00,
    "originalCurrencyCode": 826
  },
  "precedingRelatedTransactionToken": "8a6d911e-cb3d-41d2-b843-5f9dc97d503c",
  "network": "VISA",
  "subnetwork": "VISANET",
  "cardAcceptor": {
    "mid": "11111",
    "mcc": "6411",
    "name": "EM",
    "city": "Seattle",
    "state": "WA",
    "countryCode": "USA"
  }
}
Copy
Copied
{
  "type": "string",
  "state": "string",
  "token": "string",
  "userToken": "string",
  "cardToken": "string",
  "response": {
    "code": number,
    "memo": "string"
  },
  "createdTime": "string",
  "userTransactionTime": "string",
  "settlementDate": "string",
  "amount": number,
  "gpa": {
    "ledgerBalance": number,
    "availableBalance": number,
    "impactedAmount": number,
  },
  "currencyCode": "string",
  "currencyConversion": {
    "originalAmount": number,
    "conversionRate": number,
    "originalCurrencyCode": number
  },
  "precedingRelatedTransactionToken": "string",
  "network": "string",
  "subnetwork": "string",
  "cardAcceptor": {
    "mid": "string",
    "mcc": "string",
    "name": "string",
    "city": "string",
    "state": "string",
    "countryCode": "string"
  }
}

For more detailed information about this request and its response, see the API reference.

Simulate an authorisation reversal

Post/v2/simulations/transaction/authorization/reversal

Request

Use this request to simulate a card authorisation reversal.

Sample requestRequest structure
Copy
Copied
curl -i -X POST \
  'https://api.equalsmoney.com/v2/simulations/transaction/authorization/reversal' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "precedingRelatedTransactionToken": "9d3dee7c-19df-4b71-bbb9-521bb04307bf",
    "amount": 10.00
  }'
Copy
Copied
curl -i -X POST \
  'https://api.equalsmoney.com/v2/simulations/transaction/authorization/reversal' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "precedingRelatedTransactionToken": "string",
    "amount": number
  }'

Request body schema

Parameter Description
precedingRelatedTransactionToken
string
required		 The token of the transaction to work with. This is the token received in the response to the authorisation request.

Allowable values:
A valid string
amount
number
required		 The authorisation reversal amount.

Allowable values:
A valid number (>= 0)

Response

If your request is successful, you'll receive a 201 response.

Sample responseResponse structure
Copy
Copied
{
  "type": "authorization.reversal",
  "state": "CLEARED",
  "token": "7bff9f48-8c68-4937-917a-bf7cf4f0de27",
  "userToken": "f0d5cae0-fb3f-417f-8f1c-51c5fb66259a",
  "cardToken": "53494ad2-6477-402c-9f6e-dd50ea11f851",
  "response": {
    "code": 0,
    "memo": "Approved or completed successfully"
  },
  "createdTime": "2022-12-06T21:41:48Z",
  "userTransactionTime": "2022-12-06T21:41:49Z",
  "settlementDate": "2022-12-06T21:41:50Z",
  "amount": 10.00,
  "gpa": {
    "ledgerBalance": 240.00,
    "availableBalance": 240.00,
    "impactedAmount": -10.00
  },
  "currencyCode": "GBP",
  "currencyConversion": {
    "originalAmount": 10.00,
    "conversionRate": 1.00,
    "originalCurrencyCode": 826
  },
  "precedingRelatedTransactionToken": "8a6d911e-cb3d-41d2-b843-5f9dc97d503c",
  "network": "VISA",
  "subnetwork": "VISANET",
  "cardAcceptor": {
    "mid": "11111",
    "mcc": "6411",
    "name": "EM",
    "city": "Seattle",
    "state": "WA",
    "countryCode": "USA"
  }
}
Copy
Copied
{
  "type": "string",
  "state": "string",
  "token": "string",
  "userToken": "string",
  "cardToken": "string",
  "response": {
    "code": number,
    "memo": "string"
  },
  "createdTime": "string",
  "userTransactionTime": "string",
  "settlementDate": "string",
  "amount": number,
  "gpa": {
    "ledgerBalance": number,
    "availableBalance": number,
    "impactedAmount": number,
  },
  "currencyCode": "string",
  "currencyConversion": {
    "originalAmount": number,
    "conversionRate": number,
    "originalCurrencyCode": number
  },
  "precedingRelatedTransactionToken": "string",
  "network": "string",
  "subnetwork": "string",
  "cardAcceptor": {
    "mid": "string",
    "mcc": "string",
    "name": "string",
    "city": "string",
    "state": "string",
    "countryCode": "string"
  }
}

For more detailed information about this request and its response, see the API reference.