How to add a new Authorised Charge

An authorised charge verifies that the credit card or bank account associated is valid and that there are enough funds available. All authorised payments can be captured or cancelled in the future.

From the Paydock Dashboard

  1. Log into your Paydock Production or Sandbox account;
  2. Navigate to Charges from the menu on the left;
  3. Switch to the Add new tab;
  4. Choose the Pre-Auth option from the drop-down list from the Select Payment Type section;

5. Fill in the details of the charge* ;

6. Click Create Charge.


* Every service (gateway) has a set of required fields. If you miss one of them, the charge will not be created. To prevent it, please check here what fields are mandatory to fill in.

Note: Not all gateways support authorization. You can find gateways that support an authorised charge here: MasterCard, Stripe, Fiserv, EMS, CyberSource, Till Payments.

From the Paydock API

Make a POST /v1/charges?capture=false request passing in required parameters. The request example can be found here:

curl --location -g --request POST '{{url}}/v1/charges?capture=false' \
--header 'x-user-secret-key: {{secretkey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
   "amount": "10.00",
   "currency": "AUD",
   "customer": {
       "payment_source": {
           "gateway_id": "5cbede1f151b842653e987be",
           "card_name": "Wanda Mertz",
           "card_number": "4242424242424242",
           "expire_month": "01",
           "expire_year": "21",
           "card_ccv": "123"
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us