- Ghid de integrare
- Caracteristici acceptate (Opțiuni de plată)
- Plăți structurate
- Paylater Installments
Paylater Installments
Paylater Installments permit plătitorilor să plătească pentru achizițiile lor prin rate lunare până când suma este achitată integral.
Paylater Installments oferă:
- Oferte generice: Structurările de plată pe care doriți să le oferiți care nu sunt specifice articolelor, produselor sau coșului.
- Oferte de articole: Structurările de plată pe care doriți să le oferiți pentru un anumit articol sau un produs.
- Oferte coș: Structurările de plată pe care doriți să le oferiți pentru un coș cu unul sau mai multe articole sau produse.
Termenii structurării de plată în Paylater Installments pot conține următoarele:
- Perioada de grație în care plătitorul poate alege să amâne prima plată.
- Componenta ratei dobânzii sau structurările de plată fără dobândă de la banca emitentă.
- Recompense în numerar pentru alegerea anumitor structurări de plată.
Pași pentru integrare
| Nume plată structurată | Identificator plată structurată | Descriere | API de utilizat |
|---|---|---|---|
1 |
Plătitorul vizitează site-ul dvs. web |
Vreți să știți dacă există oferte de structurări de plată generice care pot fi prezentate. |
Shopping Options Inquiry Trebuie să trimiteți o solicitare Răspunsul conține o listă de oferte de structurări de plată pentru comerciant. |
2 |
Plătitorul răsfoiește o categorie sau efectuează o căutare de produs |
Doriți să afișați ofertele structurării de plată disponibile pentru fiecare articol din listă. |
Item Payment Plan Offers Trebuie să trimiteți o solicitare Răspunsul conține o listă de oferte de structurări de plată pentru articol. |
3 |
Plătitorul vede o pagină cu detalii despre produs |
Doriți să afișați ofertele structurării de plată pentru acest articol |
Item Payment Plan Offers Trebuie să trimiteți o solicitare WS API ITEM_PAYMENT_PLAN_OFFERS pentru a întreba despre ofertele structurării de plată pentru un singur articol (adică, lista conține doar un singur articol). Răspunsul conține o listă de oferte de structurări de plată pentru articol. |
4 |
Plătitorul vizualizează coșul de cumpărături și indică faptul că dorește să valideze achiziția sau pe pagina de validare. |
Doriți să afișați
|
Opțiuni de plată, inclusiv produsele din structurarea de plată Trebuie să trimiteți o solicitare WS API PAYMENT_OPTIONS_INQUIRY pentru a vă informa despre
Răspunsul conține produsul structurării de plată ca „Paylater Installments”. |
5 |
Plătitorul a selectat produsul structurării de plată ca „Paylater Installments” |
Doriți să afișați toate ofertele de structurare plată pentru acest produs cu plan structurare plată |
Opțiuni de plată, inclusiv produsele din structurarea de plată Trebuie să trimiteți o solicitare WS API PAYMENT_OPTIONS_INQUIRY pentru a întreba despre oferta de structurare plată disponibilă pentru acest produs de structurare plată Răspunsul conține o listă de oferte de structurare plată pentru coș sau o comandă și produsul tip structurare plată. |
6 |
Plătitorul a furnizat BIN-ul cardului (când a introdus numărul cardului) |
În funcție de BIN-ul cardului pe care doriți să îl afișați
|
Opțiuni de plată, inclusiv ofertele de structurare plată pentru coș sau comandă Trebuie să trimiteți o solicitare WS API PAYMENT_OPTIONS_INQUIRY pentru a vă informa despre
Răspunsul conține o listă de oferte de structurare de plată pentru coș sau comandă și BIN. |
7 |
Plătitorul acceptă oferta structurării de plată pentru coș și este de acord cu termenii și condițiile |
Doriți să transmiteți acceptarea ofertei de către plătitor. |
Dacă plătitorul selectează una dintre ofertele din cadrul acelei metode de plată ca „Paylater Installments”, trebuie să furnizați termenii și condițiile returnate în răspunsul PAYMENT_OPTIONS_INQUIRY pentru ofertele de coș, iar plătitorul trebuie să accepte oferta pentru a continua cu această structurare de plată. Acceptă oferta Afișați plătitorului termenii și condițiile (detaliile furnizate în răspunsul PAYMENT_OPTIONS_INQUIRY). Plătitorul acceptă termenii și condițiile.
Apoi, trimiteți o solicitare UPDATE_PAYMENT_PLAN_OFFER. Solicitarea trebuie să conțină
Răspunsul indică dacă puteți continua cu comanda, inclusiv cu această ofertă. Dacă
|
8 |
Plătitorul continuă cu plata |
- |
Solicitare Authorize sau Pay Comerciantul trimite o solicitare WS API AUTHORIZE sau PAY cu ID-ul ofertei de structurare plată acceptate. Oferta de structurare de plată pentru coș pe care plătitorul a acceptat-o devine acum structurarea de plată pentru comandă sau tranzacție. |
Referință API Payment Options Inquiry [REST][NVP]
Shopping Options Inquiry
Puteți solicita gateway-ului o listă de oferte generice de structurare valide utilizând operațiunea de interogare Shopping Options Inquiry. Vor fi returnate detaliile de mai jos despre plățile structurate acceptate:
Începând cu versiunea 70, răspunsul conține produsele acceptate pentru structurarea de plată, care este „Paylater Installments”:
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrl
Fiecare ofertă de structurare de plată are un ID de ofertă unic și ID-ul de produs corespunzător al structurării de plată:
paymentPlanOffer.{id}paymentPlanOffer.{id}.currency (populated with payerCurrency from request)paymentPlanOffer{id}.paymentPlanProductIdpaymentPlanOffer{id}.totalAmountpaymentPlanOffer{id}.numberOfPaymentspaymentPlanOffer{id}.subsequentPaymentAmountpaymentPlanOffer{id}.firstPaymentAmountpaymentPlanOffer{id}.deferalPeriodpaymentPlanOffer{id}.interest.ratepaymentPlanOffer{id}.interest.discountAmountpaymentPlanOffer{id}.feeAmountpaymentPlanOffer{id}.cashAward.amountpaymentPlanOffer{id}.cashAward.payerInstructionTextpaymentPlanOffer{id}.qualifier.descriptionpaymentPlanOffer{id}.qualifier.logoUrlpaymentPlanOffer{id}.minimumAmountpaymentPlanOffer{id}.maximumAmountItem Payment Plan Offers
Puteți solicita gateway-ului o listă de oferte de structurare plată valide pentru un anumit articol utilizând operațiunea Item Payment Plan Offers.
Solicitarea conține următoarele detalii:
merchantpayerlocalecurrencyitem[0].skuitem[0].unitPriceitem[1].skuitem[1].unitPriceVor fi returnate detaliile de mai jos despre plățile structurate acceptate. Începând cu versiunea 70, răspunsul conține produsele acceptate pentru structurarea de plată, respectiv „Paylater Installments”:
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrl
Fiecare ofertă de structurare de plată are un ID de ofertă unic și ID-ul de produs corespunzător al structurării de plată:
item[n].paymentPlanOffer.{id}item[n].paymentPlanOffer.{id}.paymentPlanProductIditem[n].paymentPlanOffer.{id}.currencyitem[n].paymentPlanOffer.{id}.totalAmountitem[n].paymentPlanOffer.{id}.numberOfPaymentsitem[n].paymentPlanOffer.{id}.deferalPerioditem[n].paymentPlanOffer.{id}.subsequentPaymentAmountitem[n].paymentPlanOffer{id}.firstPaymentAmountitem[n].paymentPlanOffer{id}.interest.rateitem[n].paymentPlanOffer{id}.interest.discountAmountitem[n].paymentPlanOffer{id}.feeAmountitem[n].paymentPlanOffer{id}.cashAward.amountitem[n].paymentPlanOffer{id}.cashAward.payerInstructionTextitem[n].paymentPlanOffer{id}.qualifier.descriptionitem[n].paymentPlanOffer{id}.qualifier.logoUrlresult
Payment Plan Inquiry
Puteți solicita gateway-ului o listă de produse valide tip structurare plată și oferte de structurare utilizând operațiunea Payment Options Inquiry.
Solicitarea conține:
payerLocaleorder.amountorder.currencyorder.item[n].skuorder.item[n].quantityorder.item[n].unitPriceorder.itemAmountsourceOfFunds.provided.card.prefix
Începând cu versiunea 70, răspunsul conține produsele acceptate pentru structurarea de plată, respectiv „Paylater Installments”:
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrlFiecare ofertă de structurare de plată are un ID de ofertă unic și ID-ul de produs corespunzător al structurării de plată:
paymentTypes.card.paymentPlanOffer.{id}paymentTypes.card.paymentPlanOffer.{id}.paymentPlanProductIdpaymentTypes.card.paymentPlanOffer.{id}.numberofPaymentspaymentTypes.card.paymentPlanOffer.{id}.deferralPeriodpaymentTypes.card.paymentPlanOffer.{id}.interest.chargedpaymentTypes.card.paymentPlanOffer.{id}.currencypaymentTypes.card.paymentPlanOffer.{id}.minimumOrderAmountpaymentTypes.card.paymentPlanOffer.{id}.startDatepaymentTypes.card.paymentPlanOffer.{id}.endDatepaymentTypes.card.paymentPlanOffer.{id}.totalAmountpaymentTypes.card.paymentPlanOffer.{id}.firstPaymentAmountpaymentTypes.card.paymentPlanOffer.{id}.subsequentPaymentAmountpaymentTypes.card.paymentPlanOffer.{id}.feeAmountpaymentTypes.card.paymentPlanOffer.{id}.interest.ratepaymentTypes.card.paymentPlanOffer.{id}.interest.discountAmountpaymentTypes.card.paymentPlanOffer.{id}.termsAndConditions.textpaymentTypes.card.paymentPlanOffer.{id}.termsAndConditions.acceptanceRequiredpaymentTypes.card.paymentPlanOffer.{id}.termsAndConditions.acceptanceTextpaymentTypes.card.paymentPlanOffer.{id}.cashAward.amountpaymentTypes.card.paymentPlanOffer.{id}.cashAward.payerInstructionTextpaymentTypes.card.paymentPlanOffer.{id}.qualifier.textpaymentTypes.card.paymentPlanOffer.{id}.qualifier.logoUrl
Update Payment Plan Offers
Puteți trimite furnizorului acceptarea de către plătitor a ofertelor de structurare plată utilizând operațiunea Update Payment Plan Offers.
- Solicitarea conține:
sourceOfFunds parameter grouporder.amountorder.currencyorder.item[n].quantityorder.item[n].unitPrice
Puteți furniza detaliile pentru acceptarea plătitorului, indicând:
paymentPlanOffer.payerAcceptance = truepaymentPlanOffer.termsAndConditionsDisplayAceasta poate fi una dintre următoarele valori:
NONE– nu ați afișat niciun text de termeni și condiții.TERMS_AND_CONDITIONS_ONLY– ați afișat textul termenilor și condițiilor.TERMS_AND_CONDITIONS_AND_ACCEPTANCE– ați afișat textul termenilor și condițiilor și ați obligat plătitorul să accepte termenii și condițiile.
Trimiteți o tranzacție cu structurarea de plată
Pentru a trimite o tranzacție cu structurarea de plată selectată de plătitor, completați următoarele câmpuri într-o solicitare Authorize/Pay sau Update Session. Începând cu versiunea 70, completați câmpul paymentPlan.offerID cu ID-ul ofertei din răspunsul la Payment Options Inquiry.
Gateway-ul procesează o structurare de plată numai dacă sunt îndeplinite următoarele condiții:
- Moneda comenzii este acceptată pentru structurarea plății.
- Valoarea comenzii depășește valoarea minimă comandată definită în structurarea plății.
- Tipul de card este acceptat pentru structurarea plății.