Data Model - Payment Channel

Payment Channel Overview

The Payment Channel data model defines the structure for payment method and processing information. This model encapsulates payment method specifications, processing details, and channel-specific parameters.

Data Model Structure

Parameter	Type	Description
paymentMethod	String	Payment method identifier Format: Predefined payment method codes Examples: BRI, UPI, QRPAY, PIX, SPEI Used to identify the specific payment channel for transaction processing
vaNumber	String	Virtual Account or Bank Account number Format: Alphanumeric string Usage: Indonesia VA numbers, Thailand bank accounts, Mexico SPEI accounts Required for bank transfer payment methods
qrString	String	QR code data or image URL Format: String or HTTP image URL Usage: Indonesia QRIS, Thailand QRPAY, Brazil PIX Contains QR code data for mobile payment processing
paymentUrl	String	Primary payment processing URL Format: Valid HTTP/HTTPS URL Usage: Smilepayz checkout page for payment completion Required for all payment methods
receiverBankName	String	Recipient bank name for bank transfers Format: UTF-8 encoded string Usage: Thailand BANK method, Mexico SPEI Specifies the receiving bank for transfer transactions
additionalInfo	Object	Additional payment processing information Format: JSON object Usage: Extended payment URLs, processing parameters Contains supplementary data for specific payment methods

Regional Implementation Examples

Indonesia Payment Methods

{
    "additionalInfo": {
        "paymentUrl": "https://link.dana.id/pay?bizNo=xxxxxxxxxL5dm6QkXs3kDg5HFBtgOtgHmPWpLD9IU2qoxkqQhGJQfCYcn4tA8930VR%2BggxOHPDhZg%3D%3D&forceToH5=false"
    },
    "paymentMethod": "W_DANA",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200192501021315010115"
}

{
    "additionalInfo": {},
    "paymentMethod": "QRIS",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200112410241325417215",
    "qrString": "https://gateway.smilepayz.com/image/MER202110293394047135422905011630451D5.img"
}

{
    "additionalInfo": {},
    "paymentMethod": "QRIS",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200112410241325417215",
    "qrString": "0912121.2232323293.2323232.33xxxxxxxxxxxxxxxxxx3232wewess.w2323.QRIS.sdfdN.nubo.bsdfdc833434343"
}

{
    "additionalInfo": {},
    "paymentMethod": "BRI",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200112501021320331776",
    "vaNumber": "1419001332911089"
}

India Payment Methods

{
    "additionalInfo": {
        "paymentUrl": "upi://xxxxx612963233324SPOphhnctVDAIN5zq9s1z7cgoHpJkjnMXjGoMpMm0AD9IU2qoxkqQhGJQfCYcn4tA8930VR%2BggxOHPDhZg%3D%3D&forceToH5=false"
    },
    "paymentMethod": "UPI",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200192501021315010115"
}

{
    "additionalInfo": {
        "paymentUrl": "https://xxxxx612963233324SPOphhnctVDAIN5zq9s1z7cgoHpJkjnMXjGoMpMm0AD9IU2qoxkqQhGJQfCYcn4tA8930VR%2BggxOHPDhZg%3D%3D&forceToH5=false"
    },
    "paymentMethod": "UPI",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200192501021315010115"
}

Thailand Payment Methods

{
    "additionalInfo": {},
    "paymentMethod": "QRPAY",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=111200572411191251468673",
    "qrString": "00020101021229370016A0000006770101110113006680870163353037645406299.985802TH63048436"
}

{
    "additionalInfo": {},
    "paymentMethod": "BANK",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1112001125042408363186433",
    "receiverBankName": "KBANK",
    "vaNumber": "2053617290"
}

Brazil Payment Methods

{
    "additionalInfo": {},
    "paymentMethod": "PIX",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=131200112412130836186234",
    "qrString": "00020101021226800014br.gov.bcb.pix2558pix.delbank.com.br/v2/cob/vcharge1f6aed0623644c24bbdc174ce5204000053039865802BR5907DELBANK6007ARACAJU62070503***6304BC39"
}

Mexico Payment Methods

{
    "additionalInfo": {},
    "paymentMethod": "SPEI",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1412075825061113364201615",
    "receiverBankName": "STP",
    "vaNumber": "6461805637046123212"
}

Peru Payment Methods

{
    "additionalInfo": {
        "paymentUrl": "https://checkout.pe.1pago.net/checkout/checkout-s.html?TokenID=e064c70d-3f1b-48f1-a628-2448f51bc54f&CountryID=PER&ChannelID=ONLINE"
    },
    "paymentMethod": "CASHIER_PE",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1512024025061111131298291"
}

Colombia Payment Methods

{
    "additionalInfo": {
        "paymentUrl": "https://checkout.co.1pago.net/checkout/checkout-s.html?TokenID=e064c70d-3f1b-48f1-a628-2448f51bc54f&CountryID=COL&ChannelID=ONLINE"
    },
    "paymentMethod": "CASHIER_CO",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1512024025061111131298291"
}

Chile Payment Methods

{
    "additionalInfo": {
        "paymentUrl": "https://checkout.cl.1pago.net/checkout/checkout-s.html?TokenID=e064c70d-3f1b-48f1-a628-2448f51bc54f&CountryID=CHL&ChannelID=ONLINE"
    },
    "paymentMethod": "CASHIER_CL",
    "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1512024025061111131298291"
}

Implementation Guidelines

Payment Method Selection

• Digital Wallets: Use e-wallet specific payment methods with additional payment URLs
• QR Payments: Include QR string data for mobile payment processing
• Bank Transfers: Provide virtual account numbers and receiver bank information
• Cash Payments: Use cashier payment methods with external checkout URLs

Security Considerations

• URL Validation: Ensure all payment URLs use HTTPS protocol
• Data Encryption: Sensitive payment data should be encrypted in transit
• Token Management: Secure handling of payment tokens and session data
• Audit Logging: Maintain comprehensive logs for payment processing activities