Create retail transaction

POST

/v1.0/retail/create

Request

Body Params application/json

partnerReferenceNo

string

required

transaction id generated by merchant

validUpTo

string

required

expiry time, YYYY-MM-DDTHH:mm:ss+07:00

customerName

string

required

customer name

customerEmail

string

required

customer email

customerPhone

string

optional

customer phone

amount

object

required

amount

currency

string

required

currency IDR

value

string

required

amount value

urlParams

array [object {2}]

optional

url

string

required

type

string

required

PAY_RETURN
NOTIFICATION

additionalInfo

object

required

channel

string

required

RETAIL_ALFAMART
RETAIL_PEGADAIAN
RETAIL_POS_INDONESIA
RETAIL_ALFAMIDI
RETAIL_DANDAN

Example

{
    "partnerReferenceNo": "string",
    "validUpTo": "string",
    "customerName": "string",
    "customerEmail": "string",
    "customerPhone": "string",
    "amount": {
        "currency": "string",
        "value": "string"
    },
    "urlParams": [
        {
            "url": "string",
            "type": "string"
        }
    ],
    "additionalInfo": {
        "channel": "string"
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sandbox.ayolinx.id/v1.0/retail/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "partnerReferenceNo": "string",
    "validUpTo": "string",
    "customerName": "string",
    "customerEmail": "string",
    "customerPhone": "string",
    "amount": {
        "currency": "string",
        "value": "string"
    },
    "urlParams": [
        {
            "url": "string",
            "type": "string"
        }
    ],
    "additionalInfo": {
        "channel": "string"
    }
}'

Responses

🟢200Success

application/json

Body

responseCode

string

required

responseMessage

string

required

partnerReferenceNo

string

required

transaction id

expiryDate

string

required

expiry time

vaNumber

string

required

va number

paymentUrl

string

required

payment url

Example

{
    "responseCode": "00",
    "responseMessage": "Successful",
    "partnerReferenceNo": "ei29dh29ee233UE383hf29hr",
    "expiryDate": "2024-09-12T12:55:00+07:00",
    "vaNumber": "021113791978",
    "paymentUrl": "https://passport.duitku.com/topup/topupdirectv2.aspx?ref=FT25ONEXEAPGG3C043O"
}

Modified at 2025-06-17 06:25:49

Payment Notify

retail query