Skip to main content

Documentation

Simulate a Card Transaction Authorization Request - Non-EEA

Simulate Rapyd’s request to your authorization server.

If you have implemented Remote Authorization, Rapyd sends authorization requests to your remote authorization server when the card network requests approval of a transaction on a card issued to a Rapyd Wallet. Use this method in the sandbox.

The response contains all the fields you must send to Rapyd when you receive an authorization request in production.

This method triggers Card Issuing Sale Webhook. This webhook contains the same information as the response. See also Remote Authorization.

This method applies to cards issued outside the European Economic Area (EEA). For cards issued in the EEA, see Simulate a Card Transaction Authorization Request - EEA.

Prerequisites

    • amount

    • The amount of the authorization, in units of the currency defined in currency. Decimal.

    • card_id

    • ID of the card. String starting with card_.

    • currency

    • The currency supported by the card. Three-letter ISO 4217 code.

    • merchant_category_code

    • Four-digit merchant category code (MCC) of the initiator of the transaction, as defined in ISO 18245.

    • merchant_name_location

    • Name and location of the merchant. Maximum 40 characters.

  • /v1/issuing/cards/authorization

  • Card Transaction Authorization

  • curl -X post
    https://sandboxapi.rapyd.net/v1/issuing/cards/authorization
    -H 'access_key: your-access-key-here'
    -H 'Content-Type: application/json'
    -H 'idempotency: your-idempotency-parameter-here'
    -H 'salt: your-random-string-here'
    -H 'signature: your-calculated-signature-here'
    -H 'timestamp: your-unix-timestamp-here'
    -d '{
        "card_id": "card_ed9fddc7e809b711c938cc65ffb4cc58",
        "amount": 5,
        "currency": "USD"
    }
    '
  • {
        "status": {
            "error_code": "",
            "status": "SUCCESS",
            "message": "",
            "response_code": "",
            "operation_id": "333e030a-76f3-429b-b5cd-a3c0e40373c4"
        },
        "data": {
            "id": "cit_bfebf42294f984e69183acff99a14cc5",
            "amount": 5,
            "currency": "USD",
            "created_at": 1683098455,
            "card_id": "card_ed9fddc7e809b711c938cc65ffb4cc58",
            "merchant_category_code": "",
            "merchant_name_location": "TEST MERCHANT",
            "auth_code": "3A53EY",
            "bin": "557433",
            "last4": "7654",
            "issuing_txn_type": "SALE",
            "pos_entry_mode": "",
            "systems_trace_audit_number": "",
            "retrieval_reference_number": "2E4AE4C46E19",
            "original_transaction_id": "",
            "original_txn_amount": null,
            "original_txn_currency": "",
            "fx_rate": 1,
            "card_program_id": "cardprog_b027c85a66ebebb2e094bca626d5ae97",
            "wallet_transaction_id": "wt_c78f11aa6812fcaa4b84fc5f1ae220c9"
        }
    }