Logo
Acquired.com API API Documentation

Process a payment

POST {{url}}payments

Submit a payment request into the API and receive a response. If you want to create a card for future use, submit the full card details within the card object and set the create_card parameter to true. Make sure that you add the relating customer_id as all payments and cards must be associated to the customer. The newly created card_id value will then be returned in the response, and can be passed in the card_id parameter in the /payments/reuse or /payments/recurring endpoint.

https://docs.acquired.com/reference/create-payment

 

Body PARAM

Key Datatype Required Description 



HEADERS

Key Datatype Required Description 
Content-Type
string
Company-Id
null Unique ID assigned by Acquired.com for your company.
Mid
null Unique ID assigned by Acquired.com connecting to a specific acquiring bank. Not setting this value will enable our internal routing logic.




RESPONSES

status





Curl
curl -X POST 'https://test-api.acquired.com/v1/payments' -H 'Content-Type: application/json' -H 'Company-Id: ' -H 'Mid: ' -d '{"transaction":{"order_id":"$guid","amount":15.02,"currency":"gbp","moto":false,"capture":true,"custom_data":"L3BheW1lbnQtbGlua3MgcGF5IGN1c3RvbV9kYXRh","custom1":"string","custom2":"string"},"payment":{"card":{"holder_name":"E Johnson","scheme":"visa","number":"4000015979612025","expiry_month":1,"expiry_year":26,"cvv":"123"},"create_card":false,"reference":"Custom Ref 001"},"customer":{"customer_id":"32319a11-7720-44e1-808e-2bd2eb88ac2a"},"tds":{"is_active":true,"challenge_preference":"no_preference","challenge_window_size":"full_screen","contact_url":"https://yourdomain.com/contact","redirect_url":"https://qaacs.acquired.com/merchant_redirect/test_success","webhook_url":"https://yourdomain.com/webhook"}}'

ENDPOINTS