Skip to main content

Documentation

Simulate a Card Refund - Non-EEA

Simulate a retail location making a refund to an issued card.

This method applies to cards issued outside the European Economic Area (EEA). For cards issued in the EEA, see Simulate a Card Refund - EEA. Use this method in the sandbox.

This method triggers Card Issuing Refund Webhook. This webhook contains the same information as the response.

Prerequisites:

    • amount

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

    • card_id

    • ID of the card. String starting with card_.

    • currency

    • The refund currency. Three-letter ISO 4217 code.

    • merchant_category_code

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

    • merchant_name_location

    • The name and location of the merchant that initiates the refund.

  • /v1/issuing/cards/refund

  • Card Refund

  • curl -X post
    https://sandboxapi.rapyd.net/v1/issuing/cards/refund
    -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 '{
        "amount": 5,
        "card_id": "card_ed9fddc7e809b711c938cc65ffb4cc58",
        "currency": "USD"
    }
    '
    
  • {
        "status": {
            "error_code": "",
            "status": "SUCCESS",
            "message": "",
            "response_code": "",
            "operation_id": "b9397820-6487-4883-a643-0c4d5c1341ac"
        },
        "data": {
            "id": "cit_9d821ddfda8b22c9e4e447fcf2f91113",
            "amount": 5,
            "currency": "USD",
            "created_at": 1683526097,
            "card_id": "card_ed9fddc7e809b711c938cc65ffb4cc58",
            "merchant_category_code": "",
            "merchant_name_location": "TEST MERCHANT",
            "auth_code": "",
            "bin": "557433",
            "last4": "7654",
            "issuing_txn_type": "REFUND",
            "pos_entry_mode": "",
            "systems_trace_audit_number": "",
            "retrieval_reference_number": "",
            "original_transaction_id": "",
            "original_txn_amount": null,
            "original_txn_currency": "",
            "fx_rate": 1,
            "card_program_id": "cardprog_b027c85a66ebebb2e094bca626d5ae97",
            "wallet_transaction_id": ""
        }
    }