Simulate Authorization and Settlement

Overview

Use these endpoints to create simulated authorizations and settlement in the staging environment. (Galileo only).

Simulate Authorization

POST {{domain}}/test_api/v1/card_issuing/accounts/:id/simulate/authorization

Request

Sample Request

{
    "amount": 120,
    "card_network": "visa",
    "currency": "840",
    "merchant_name": "Big Box Store"
}

Response

Sample Response

{
    "data": {
        "authorization_id": "20052"
    }
}

Notes

• An authorization can be successfully simulated but still results in denied authorization due to insufficient balances, wrong currencies, etc. In such cases, an authorization_id is still returned, and using this authorization_id to create simulated settlements will result in failures. Currently, a denied authorization webhook that informs users of denied authorizations is under development.

Simulate Settlement

POST {{domain}}/test_api/v1/card_issuing/accounts/:id/simulate/settlement

Request

Sample Request

{
    "authorization_id": "20052",
    "card_network": "visa",
    "currency": "840",
    "merchant_name": "Big Box Store"
}

Response

Sample Response

{
    "data": {
        "authorization_id": "20052"
    }
}

Error Response

Sample Response

{
    "error": {
        "code": "invalid_status",
        "message": "Authorization is already settled or in the wrong status."
    }
}