GAgalileo-ft
Transaction Simulation

Create Simulated Card Settlement

Changed on

Use the Create Simulated Card Settlement endpoint to settle a simulated card authorization in the <glossary:CV> environment. First, create a simulated authorization using the <a href="ref:post_createsimulatedcardauth" target="_blank">Create Simulated Card Authorization</a> endpoint, and then use this endpoint to settle it.

  • If authId is not populated, then merchantName is required. Populate merchantName but not authId to simulate a force-posted transaction.
  • For instructions on using this endpoint see <a href="doc:simulating-card-transactions" target="_blank">Simulating Card Transactions</a>.

[block:callout]

{ "type": "warning", "title": "Warning", "body": "This endpoint does not support XML responses. If you pass response-content-type: xml, it will be ignored." } [/block]

[block:callout]

{ "type": "warning", "title": "Warning", "body": "Do not use this endpoint in <glossary:Production>." } [/block]

post/createSimulatedCardSettle

Request

  • Base URL
    api-{corename}.{env}.gpsrv.com/intserv/4.0/ (relative, and the document’s source URL is not known)
  • URL
    api-{corename}.{env}.gpsrv.com/intserv/4.0/createSimulatedCardSettle
  • Auth
    none declared

Request body application/x-www-form-urlencoded

apiLoginstring required

Web service username, as provided by Galileo. Pattern: Max 50 characters Example: "AbC123-9999"

apiTransKeystring required

Web service password, as provided by Galileo. Pattern: Max 15 characters Example: "4sb62fh6w4h7w34g"

providerIdinteger required

Galileo-issued provider identifier. Pattern: Max 10 digits Example: 9999

transactionIdinteger required

A unique provider-generated ID to identify this API call. A UUID is preferred. Pattern: 60 characters or less Example: "9845dk-39fdk3fj3-4483483478"

accountNostring required

The <glossary:PRN> or <glossary:PAN> of the account. Pattern: PAN or PRN Example: "074103447228"

amountnumber required

The amount of the transaction in the currency at the point of sale. Pattern: Positive integer or decimal number Example: 100.00, 100, or 100.73

associationstring required

Specifies which card network to simulate: visa (Visa), mc_auth (Mastercard Credit).<!--`mc_debit` (Mastercard Debit), `star` (STAR), `coop` (Co-op), `visa_baseii` (Visa Base II), or `allpoint` (Allpoint).--> Pattern: string Example: "visa"

merchantNamestring required

Simulated merchant name. Pass 40 characters for the complete string or pass up to 22 characters and the simulator will add 18 characters of a simulated address. For settlements, this parameter is required when authId is not populated. Pattern: Max 40 alphanumeric characters Example: "Fred Jones Bagels"

currencyCodestring

The currency code for amount. Use ISO 4217 numeric currency codes. This parameter is required when using this endpoint outside the United States. Pattern: 3 digits Example: "840"

settleAmountnumber

The amount to be transferred from merchant to issuer in the settlement currency. Required when currencyCode differs from the account currency, or when specialFunctions: make_multicurrency. Pattern: Positive integer or decimal number Example: 100.00, 100, or 100.73

settleCurrencyCodestring

The currency code for settleAmount. Use ISO 4217 numeric currency codes. Required when currencyCode differs from the account currency, or when specialFunctions: make_multicurrency. Pattern: 3 digits Example: "124"

cardBillingAmountnumber

The amount that will be posted to the cardholder account in the currency of the account. Required when currencyCode differs from the account currency, or when specialFunctions: make_multicurrency. Pattern: Positive integer or decimal number Example: 100.00, 100, or 100.73

cardBillingCurrencyCodestring

The currency code for cardBillingAmount. Use ISO 4217 numeric currency codes. Required when currencyCode differs from the account currency, or when specialFunctions: make_multicurrency. Pattern: 3 digits Example: 484

authIdstring

The authorization ID (auth_id) as returned by the <a href="ref:post_createsimulatedcardauth" target="_blank">Create Simulated Card Authorization</a> endpoint. If this parameter is not populated then merchantName is required. Pattern: Positive integer Example: 58344373

Response

status_codeinteger nullable required

The response status code. May return a string for some statuses.

statusstring nullable required

The condition of a process or response

processing_timenumber nullable required

The time elapsed in processing the transaction

system_timestampstring date-time nullable required

A system generated timestamp

rtokenstring nullable required

A Galileo-generated ID used for tracking

errorsstring[]

A list of errors generated while the request was processed

Changes