Skip to main content

Create a Hosted Payment

POST 
/hosted-payments

Create a Hosted Payment to collect payment from your customer. When this request succeeds, redirect the customer to the URL in the redirectUrl field of the response so that they can make the payment. They will be redirected back to the URL in returnUrl when they complete the payment flow.

When the customer has successfully made the payment, the status field will be updated to SUCCEEDED, and Acme will send a hosted-payments.succeeded webhook to you.

Should the payment fail, the status field will be updated to FAILED, and Acme will send a corresponding hosted-payments.failed webook. The resultCode field may contain additional information about the failure.

Request​

Responses​

OK

Response Headers
    Acme-Mode

    Has the value LIVE if the data exists in live production mode or the value TEST if the data exists in test sandbox mode.