Skip to main content
POST
/
requests
Payment Request
curl --request POST \
  --url https://testapi.fractalpay.com/api/v1/requests \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "4.00",
  "merchant_key": "{{merchant_key}}",
  "order_id": "5465",
  "phone_number": "8594651447",
  "preauth": false,
  "invoice_number": "345"
}
'
{
  "data": {
    "order_id": "5465",
    "qr_code_link": "https://testapi.fractalpay.com/authcheck-paymentlink/h9jfippu2jn",
    "sales_id": "c9d48736-edbf-11ee-b78a-02fabd890500"
  },
  "message": "Text request has been sent"
}

Authorizations

​
Authorization
string
header
required

Use your Fractal API credentials.

Username = Client ID Password = Secret Key

Sandbox credentials can be generated from the Test Portal.

Headers

​
api_key
string
Example:

"8af9a5a0e6338fbafd8d2fa7a688fd16363cc865c6e6ede3002d041c2613cb99"

Body

application/json
​
amount
string
required
Example:

"4.00"

​
merchant_key
string
required

The merchant's unique key. Returned in the merchant_key field of the get merchants by client call.

Example:

"{{merchant_key}}"

​
order_id
string
required
Example:

"5465"

​
phone_number
string
Example:

"8594651447"

​
preauth
boolean
Example:

false

​
invoice_number
string
Example:

"345"

​
allow_card
boolean
default:true

Allow card as a payment method. At least one of allow_card or allow_ach must be true — setting both to false will result in an error.

Example:

true

​
allow_ach
boolean
default:true

Allow ACH as a payment method. At least one of allow_card or allow_ach must be true — setting both to false will result in an error.

Example:

true

Response

201 - application/json

Payment Request

​
data
object
​
message
string
Example:

"Text request has been sent"