Create a payment

Body

• amount integer Required
  The price in minor units of currency: 4900 with USD is $49.00. From the equivalent of $1.00 up to 1,000,000.00 in the currency.
• currency string
  USD, EUR, GBP, CAD, AUD. Defaults to USD.
• reference string
  Your ID for the payment, such as an order number, up to 64 characters. It names one live payment: one that isn't canceled or expired.
• description string
  Shown in the checkout's details and on the receipt, up to 300 characters.
• customer_email string
  Links the payment to the customer with this email, adding one if needed. Without it, customer_id stays null until checkout collects an email.
• success_url string
  Where checkout sends the customer after paying, with payment_id added to its query. Use https://; http:// works only for localhost and 127.0.0.1. Defaults to the redirect in your checkout settings, then the receipt.
• cancel_url string
  Where to send the customer if they leave without paying. Use https://; http:// works only for localhost and 127.0.0.1.
• expires_at timestamp
  From 15 minutes to 30 days after 402pay receives the request, so give a 15-minute expiry a few seconds' margin. Defaults to 24 hours.
• metadata object
  Up to 20 string pairs of your own. Keys are up to 40 letters, digits, _, . or -. See metadata.
• fee_payer string
  Who pays 402pay's fee on this payment: business or customer. Defaults to your checkout settings. With customer, checkout adds the fee for the method the customer picks to their total, as passing fees on describes.

Errors

• 400 invalid_request
  A field is missing or out of range. field names it.
• 400 invalid_email
  customer_email isn't a valid email address.
• 409 reference_in_use
  The reference names a live payment for another amount or currency, or one that already received funds.
• 403 business_suspended
  402pay suspended your business, so it can't take new payments.
• 403 test_mode_unavailable
  A test key can't create payments on a live business, so use a live key.
• 409 not_accepting
  Your business has no wallet yet, so it can't take payments.

Any request can also fail on its key or its body. See errors.