First, tokenize your card to initialize your order.

You can use one of the following test card numbers:

curl -X POST \
-d 'card_number=5234131094136942&card_expiry_month=12&card_expiry_year=2019&card_holder=John Doe&cvc=123&multi_use=1' "https://stage-secure-vault.hipay-tpp.com/rest/v1/token/create"

Tip: Copy & Paste this command to the terminal with
: Ctrl+C / Ctrl+V
: Cmd+C / Cmd+V

Congratulations!
You’ve made your first API call.
Your token is : XXX

Now create a transaction with your card token.

curl -X POST \
-d 'orderid=DevPortal_RANDOM&operation=Sale&authentication_indicator=0&eci=7&payment_product=cb&cardtoken=c4abc1f70f10208a268b81a4babe2fc185e71657&description=Your custom description here...&currency=EUR&amount=19.90&shipping=1.50&tax=2.60&cid=02010109101010&language=fr_FR&[email protected]&phone=0987654321&issuer_bank_id=1111111191&country=FR&firstname=John&lastname=Doe&streetaddress=2 Boulevard du Montparnasse&city=Paris&state=France&zipcode=75014' "https://stage-secure-gateway.hipay-tpp.com/rest/v1/order"

Tip: you can clear the prompt with clear command.

Awesome!
Your transaction has been captured.
Your transaction reference number is : XXX

Now refund this transaction with this final command.

curl -X POST \
-d 'operation=refund&amount=3.50' "https://stage-secure-gateway.hipay-tpp.com/rest/v1/maintenance/transaction/134358062815"

Tips: you can clear the prompt with clear command.

Your order has been successfully refunded!
Congrats!

You have finished all tasks successfully. Great job!

You’ve made your first API calls to Tokenize your card, Create a transaction and Refund it.

You can now read the full API documentation for more details.

Let’s try another developer tool: our payment page simulator.

Try our simulator