- Ghid de integrare
- Caracteristici acceptate (Opțiuni de plată)
- Plăți structurate
- Plăți structurate personalizate
Plăți structurate personalizate
Plățile structurate personalizate se bazează pe un sistem de șablon-instanță, prin care puteți să creați instanțe ale unuia dintre cele 5 șabloane de plată structurată, specificând numărul de rate și perioada de grație (dacă este cazul).
- Plată în rate, fără dobândă
- Plată în rate după o perioadă de grație, cu dobândă
- Plată în rate, cu dobândă
- Plată suma totală după o perioadă de grație
- Plată în rate după o perioadă de grație, fără dobândă
De exemplu, puteți crea următoarele plăți structurate:
- Ofertă sfârșitul anului financiar - fără dobândă, fără plăți timp de șase luni (o instanță a șablonului 5)
- Achitare facilă - plăți cu valoare fixă timp de trei luni, fără dobândă (o instanță a șablonului 1)
- Ofertă de Crăciun - cumpărați acum, plătiți toată suma peste șase luni (o instanță a șablonului 4)
În prezent, plățile structurate personalizate sunt oferite de:
- Primele date Brazilia
- Primele date Argentina
Payment Plan Inquiry
Puteți solicita gateway-ului o listă de plăți structurate valide pentru o tranzacție utilizând operațiunea Payment Options Inquiry. Vor fi returnate detaliile de mai jos despre plățile structurate acceptate:
paymentTypes.card.paymentPlans[n].startDate: Data de începere a plății structurate.paymentTypes.card.paymentPlans[n].endDate: Data de încheiere a plății structurate.paymentTypes.card.paymentPlans[n].numberOfPayments[n]: Numărul de rate lunare plătibile de către plătitor (dacă se aplică pentru tipul respectiv de plată structurată).paymentTypes.card.paymentPlans[n].numberOfDeferrals[n]: Numărul de luni pentru care plata poate fi amânată (dacă se aplică pentru tipul de plată structurată).paymentTypes.card.paymentPlans[n].minimumOrderAmounts[n].amount: Valoarea minimă a comenzii pentru plata structurată în moneda acceptată. Plățile structurate configurate vor fi oferite numai dacă valoarea totală a comenzii este mai mare sau egală cu valoarea minimă a comenzii.paymentTypes.card.paymentPlans[n].minimumOrderAmounts[n].currency: Moneda pentru valoarea minimă a comenzii.paymentTypes.card.paymentPlans[n].payerInterest: Indică dacă plătitorul plătește o dobândă pentru plata structurată.paymentTypes.card.paymentPlans[n].planId: Un identificator unic, generat de sistem pentru plata structurată. Identificatorul plății structurate este unic în cadrul tuturor tipurilor de plăți structurate configurate pentru dvs.paymentTypes.card.paymentPlans[n].planName: Un identificator pentru plata structurată furnizat de comerciant. De exemplu, Ofertă la sfârșitul anului financiar.paymentTypes.card.paymentPlans[n].planTemplate: Șablonul de plată structurată utilizat pentru generarea instanței plății structurate. De exemplu, Plată în rate, fără dobândă.
În general, există o limită de maxim 99 de rate și/sau luni de grație. Totuși, your payment service provider poate configura limita maximă pentru fiecare șablon ca parte a configurației comerciantului.
Începând cu versiunea 70, pentru ID-ul de structurare plată generat de sistem, se returnează ofertele de structurare plată disponibile. Este returnată o listă de oferte de structurare plată, în funcție de monedă și valoarea minimă a comenzii.
Fiecare ofertă de structurare plată are un ID unic de ofertă:
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrlpaymentTypes.card.paymentPlanOffer.{id}paymentTypes.card.paymentPlanOffer{id}.paymentPlanProductIdpaymentTypes.card.paymentPlanOffer.{id}.currencypaymentTypes.card.paymentPlanOffer.{id}.numberofPaymentspaymentTypes.card.paymentPlanOffer.{id}.subsequentPaymentAmountpaymentTypes.card.paymentPlanOffer.{id}.firstPaymentAmountpaymentTypes.card.paymentPlanOffer{id}.minimumOrderAmountpaymentTypes.card.paymentPlanOffer.{id}.deferralPeriodpaymentTypes.card.paymentPlanOffer.{id}.interest.chargedpaymentTypes.card.paymentPlanOffer.{id}.startDatepaymentTypes.card.paymentPlanOffer.{id}.endDatepaymentTypes.card.paymentPlanOffer.{id}.planTemplate
Referință API Payment Options Inquiry [REST][NVP]
Solicitați o plată structurată
Pentru a solicita o structurate de plată pentru o tranzacție, completați următoarele câmpuri dintr-un Authorize/Pay sau o solicitare Update Session:
paymentPlan.numberOfDeferralspaymentPlan.numberOfPaymentspaymentPlan.planId
Gateway-ul procesează o structurate de plată numai dacă sunt îndeplinite următoarele condiții:
- Data curentă este ulterioară sau egală cu data de începere.
- Data curentă este anterioară sau egală cu data de încheiere.
- Valoarea comenzii depășește valoarea minimă comandată definită în structurarea plății.
- Moneda comenzii este acceptată pentru structurarea plății.
- Tipul de card este acceptat pentru structurarea plății.
Începând cu versiunea 70, furnizați numai câmpul paymentPlan.offerID din solicitarea Authorize/Pay sau Update Session cu ID-ul ofertei furnizat în răspunsul la Payment Options Inquiry.
Referință API Plăți structurate [REST][NVP]
Limitările structurărilor de plată
Puteți limita identificatorii plăților structurate și lunile de grație/rate pentru o anumită tranzacție folosind câmpurile de limitare a structurărilor de plată:
constraints.paymentPlans.numberOfDeferrals: Numărul de luni de grație permis pentru plata structurată.constraints.paymentPlans.numberOfPayments: Numărul de rate permis pentru plata structurată.constraints.paymentPlans.supported[n]: Introduceți identificatorii structurărilor de plată acceptate pentru tranzacția respectivă. Dacă nu doriți să oferiți nicio structurare de plată, lăsați câmpul necompletat.
Începând cu versiunea 70,
constraints.paymentPlans.deferralPeriod: Numărul de luni de grație permis pentru plata structurată.constraints.paymentPlans.numberOfPayments: Numărul de rate permis pentru plata structurată.constraints.paymentPlans.supported[n]: Introduceți identificatorii structurărilor de plată acceptate pentru tranzacția respectivă. Dacă nu doriți să oferiți nicio structurare de plată, lăsați câmpul necompletat.