Fast Checkout Sandbox

POST

/api/merchant/sandbox/fastCheckOut

Fast Checkout types ONCE_OFF_FIXED,OPEN_FIXED_AMOUNT,OPEN_DYNAMIC_AMOUNT

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params multipart/form-data

string

required

Id of payment Link when updating

paymentLinkName

string

required

Name of Payment Link

Example:

Udean Mbano

paymentLinkDescription

string

required

Description of payments

Example:

Test Description

paymentLinkReference

string

required

Example:

FastCheckout0002

paymentLinkAmount

string

required

Default Amount

Example:

5.00

paymentLinkType

string

required

ONCE_OFF_FIXED,OPEN_FIXED_AMOUNT,OPE

Example:

ONCE_OFF_FIXED

paymentLinkImageType

string

required

Image Attachment

Example:

NEW

paymentLinkProfileId

string

required

NEW/UPDATE/NONE

Example:

4271941

paymentLinkStartDate

string

required

Payment profile Id

Example:

2025-02-26

paymentLinkEndDate

string

required

Start Date formart yyyy-MM-dd

Example:

2025-02-26

paymentLinkCurrency

string

required

End Date formart yyyy-MM-dd

Example:

USD

paymentLinkCurrencyId

string

required

Example:

paymentLinkOtherCurrencies

string

required

Example:

false

paymentLinkCustomerRedirectUrl

string

required

Example:

https://google.com

paymentCustomerFailRedirectUrl

string

required

Image Attachment

Example:

https://google.com

paymentLinkEmail

string

required

Example:

udean@smatechgroup.com

paymentPayerFullNames

string

required

Image Attachment

Example:

Keith Chimeto

paymentPayerEmailAddress

string

required

Example:

udean@smatechgroup.com

paymentPayerAddress

string

required

Example:

55A

paymentPayerMobile

string

required

Example:

263779627951

paymentLinkImage

file

required

Image Attachment

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://live.smatpay.africa/api/merchant/sandbox/fastCheckOut' \
--form 'id=""' \
--form 'paymentLinkName="Udean Mbano"' \
--form 'paymentLinkDescription="Test Description"' \
--form 'paymentLinkReference="FastCheckout0002"' \
--form 'paymentLinkAmount="5.00"' \
--form 'paymentLinkType="ONCE_OFF_FIXED"' \
--form 'paymentLinkImageType="NEW"' \
--form 'paymentLinkProfileId="4271941"' \
--form 'paymentLinkStartDate="2025-02-26"' \
--form 'paymentLinkEndDate="2025-02-26"' \
--form 'paymentLinkCurrency="USD"' \
--form 'paymentLinkCurrencyId="1"' \
--form 'paymentLinkOtherCurrencies="false"' \
--form 'paymentLinkCustomerRedirectUrl="https://google.com"' \
--form 'paymentCustomerFailRedirectUrl="https://google.com"' \
--form 'paymentLinkEmail="udean@smatechgroup.com"' \
--form 'paymentPayerFullNames="Keith Chimeto"' \
--form 'paymentPayerEmailAddress="udean@smatechgroup.com"' \
--form 'paymentPayerAddress="55A"' \
--form 'paymentPayerMobile="263779627951"' \
--form 'paymentLinkImage=@""'

Responses

🟢200Fast Checkout Sandbox

text/plain

Body

status

string

required

paymentLink

object

required

paymentProfileName

string

required

paymentProfileDescription

string

required

paymentLinkReference

string

required

paymentLinkUrl

string

required

paymentLinkAmount

integer

required

paymentLinkType

string

required

paymentLinkToken

string

required

paymentLinkImageUrl

string

required

paymentLinkStartDate

string

required

paymentLinkEndDate

string

required

paymentLinkIsActive

boolean

required

createdAt

string

required

integer

required

message

string

required

Example

{
    "status": "Success",
    "paymentLink": {
        "paymentProfileName": "Church Offering",
        "paymentProfileDescription": "Offering for every Sunday Service",
        "paymentLinkReference": "Pay00001",
        "paymentLinkUrl": "https://staging-payments.smatpay.africa/global?token=yr1d_ljcPzFpHV3eRRP57rbwvdj7mITG",
        "paymentLinkAmount": 10.0,
        "paymentLinkType": "ONCE_OFF_FIXED",
        "paymentLinkToken": "yr1d_ljcPzFpHV3eRRP57rbwvdj7mITG",
        "paymentLinkImageUrl": "https://smatpay.s3.af-south-1.amazonaws.com/20240805150004-VPN.png",
        "paymentLinkStartDate": "2024-07-26T00:00:00.000+00:00",
        "paymentLinkEndDate": "2024-07-26T00:00:00.000+00:00",
        "paymentLinkIsActive": true,
        "createdAt": "2024-08-05T15:00:05.045+00:00",
        "id": 14
    },
    "message": "Payment link created successfully! Image URL: https://smatpay.s3.af-south-1.amazonaws.com/20240805150004-VPN.png"
}

Modified at 2025-03-10 20:49:15

Fast Checkout